Functions/Invoke-ePOCommand.ps1
|
Function Invoke-ePOCommand { <# .SYNOPSIS Sends the command specified to the McAfee EPO server. .DESCRIPTION Sends the command specified to the McAfee EPO server. Connect-ePoServer has to be run first, as this function uses the epoServer script variable created by that functions connection to the server as well as the credentials script variable. This function is the main piece of the entire POSH-ePoAPI module. .PARAMETER Command The command to send to the McAfee EPO API. .EXAMPLE $CurrentPC = Invoke-ePOCommand -Command "system.find" -Parameters "searchText=$($env:computername)" $CurrentPC.result.list.row Returns the output of the system.find API command with a search paramter for the current computer. .NOTES Added support for -Whatif Changed from System.Net.Webclient to using Invoke-RestMethod #> [CmdletBinding(SupportsShouldProcess=$true)] param ( [Parameter(Mandatory=$True, ValueFromPipeline=$True, ValueFromPipelinebyPropertyName=$true)] [string]$Command, [string[]]$Parameters ) Begin { If(!($epoServer)) { Write-Warning "Connection to ePoServer not found. Please run Connect-ePoServer first." break } If(!($Credentials)) { $Credentials = (Get-Credential) } } Process { If(!($Parameters)) { If($PSCmdlet.ShouldProcess("$Command","Sending command to McAfee ePo API")) { $url = "$($epoServer)/remote/$($Command)?&:output=xml" } } else { If($PSCmdlet.ShouldProcess("$Command","Sending command with $($Parameters) to McAfee ePo API")) { $url = "$($epoServer)/remote/$($Command)?$($Parameters)&:output=xml" } } If($PSCmdlet.ShouldProcess("$Command","Downloading data in xml from commands sent to McAfee ePo API")) { [xml]((Invoke-RestMethod -Uri $Url -Credential $Credentials) -replace "OK:`r`n") } } End{} } |