functions/public/Get-omsAgent.ps1

function Get-omsAgent
{
    <#
        .SYNOPSIS
            Gets OMS workspace details from remote computers
        .EXAMPLE
            Get-omsAgent -computerName 'computer1', 'computer2'
        .NOTES
            Written by Ben Taylor
            Version 1.1, 08.02.2016
    #>

    [CmdletBinding()]
    [OutputType('omsAgent')]
    param (
        [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true, Position=0)]
        [ValidateNotNullOrEmpty()]
        [Alias('IPAddress', 'Name')]
        [string[]]
        $computerName = $env:COMPUTERNAME,
        [Parameter()]
        [System.Management.Automation.PSCredential]
        [System.Management.Automation.Credential()]
        $Credential
    )

    Begin
    {
        $commonSessionParams = @{
            ErrorAction = 'Stop'
        }
        
        If ($PSBoundParameters['Credential'])
        {
            $commonSessionParams.Credential = $Credential
        }
    }
    Process
    {
        forEach($computer in $computerName)
        {
            try
            {
                Write-Verbose "[$(Get-Date -Format G)] - $computer - Creating Remote PS Session"
                $psSession = New-PSSession -ComputerName $computer -EnableNetworkAccess @commonSessionParams

                Write-Verbose "[$(Get-Date -Format G)] - $computer - Trying to find Agent Version"
                Get-omsAgentInternal -computerName $computer -session $psSession
            }
            catch
            {
                Write-Error "[$(Get-Date -Format G)] - $computer - $_"
            }
            finally
            {
                if($null -ne $psSession)
                {
                    Write-Verbose "[$(Get-Date -Format G)] - $computer - Closing Remote PS Session"
                    Remove-PSSession $psSession
                }
            }
        }
    }
}