hosts/Get-CsHostId.psm1
|
function Get-CsHostId { <# .SYNOPSIS Search for hosts in your environment .PARAMETER FILTER The filter expression that should be used to limit the results .PARAMETER LIMIT The maximum records to return [default: 5000] .PARAMETER OFFSET The offset to page from, for the next result set .PARAMETER HIDDEN Switch to toggle a search of 'Hidden' devices .PARAMETER ALL Repeat request until all results are returned #> [CmdletBinding()] [OutputType([psobject])] param( [string] $Filter, [ValidateRange(1,5000)] [int] $Limit = 5000, [string] $Offset, [switch] $Hidden, [switch] $All ) begin{ if ($Filter) { Add-Type -AssemblyName System.Web } } process{ $Param = @{ Uri = '/devices/queries/devices-scroll/v1?limit=' + [string] $Limit Method = 'get' Header = @{ accept = 'application/json' 'content-type' = 'application/json' } } switch ($PSBoundParameters.Keys) { 'Hidden' { $Param.Uri = '/devices/queries/devices-hidden/v1?limit=' + [string] $Limit } 'Filter' { $Param.Uri += '&filter=' + [System.Web.HTTPUtility]::UrlEncode($Filter) } 'Offset' { $Param.Uri += '&offset=' + $Offset } 'Debug' { $Param['Debug'] = $true } 'Verbose' { $Param['Verbose'] = $true } } if ($All) { Join-CsResult -Activity $MyInvocation.MyCommand.Name -Param $Param } else { Invoke-CsAPI @Param } } } |