Functions/Connect-ePoServer.ps1
|
Function Connect-ePoServer { <# .SYNOPSIS The Connect-ePoServer function establishes a connection the McAfee EPO Server. .DESCRIPTION The Connect-ePoServer function establishes a connection the McAfee EPO Server. All results are returned in XML format. The System.Net below is to bypass unstrusted https, since by default ePo server self signs its cert. Lists all of the commands available after a successful connection has been made. .PARAMETER ePOServer The url used to access the McAfee EPO. .EXAMPLE Connect-ePoServer Connects to the default McAfee EPO Server. .EXAMPLE Connect-ePoServer -ePOServer "https://yourserver:8443" Connects to the McAfee EPO Server at https://yourserver:8443 .EXAMPLE Connect-ePoServer -ePoServer -ePOServer "https://yourserver" $ePoCommands | Where {$_.Command -like "*system*"} | Get-ePoCommandHelp This makes an active connection to the server. It then gets the command help for all of the commands that have the word system in it. .NOTES This function currently creates three script scope variables. The variable names are:wc, ePOServer, and ePoCommands. ePOServer is the url of the McAfee EPO Server. ePoCommands is a custom PowerShell object with the Command and CommandText for each command found using the core.help API command. wc is the System.Net.WebClient that has the credentials and actually sends the requests to the ePo API. Added logic to check that the connection to the ePoServer works. #> [CmdletBinding()] param ( [Parameter(Mandatory=$True, ValueFromPipeline=$True, ValueFromPipelinebyPropertyName=$true)] [string]$ePOServer, [Parameter(Mandatory=$False, ValueFromPipelinebyPropertyName=$true)] $Credentials = (Get-Credential) ) Begin { [System.Net.ServicePointManager]::ServerCertificateValidationCallback = {$true} $script:epoServer = $ePOServer $epoUser= $Credentials.GetNetworkCredential().username $epoPassword=$Credentials.GetNetworkCredential().password $script:wc=new-object System.net.WebClient $wc.Credentials = New-Object System.Net.NetworkCredential -ArgumentList ($epouser,$epopassword) } Process { $url = "$($epoServer)/remote/core.help?:output=xml" Try { $ePoCommands = [xml](($wc.DownloadString($url)) -replace "OK:`r`n") } Catch { Write-Error $_ Write-Warning "There was an error connecting to the server at $($ePoServer)" $ePOServer = $null $wc = $null } $script:ePoCommands = @() ForEach($Command in $ePoCommands.result.list.element) { $CommandName = ($Command -split ' ')[0] $CommandUse = $Command -replace ".*-" $props = @{Command=$CommandName CommandText=$CommandUse } $ePoCommands += New-Object -TypeName PSObject -Property $props } } End{} } |