Public/Get-LMCollectorVersion.ps1
|
<# .SYNOPSIS Retrieves available LogicMonitor collector versions. .DESCRIPTION The Get-LMCollectorVersions function retrieves information about available LogicMonitor collector versions. It can return all versions, top versions only, or versions filtered by specific criteria. .PARAMETER Filter A filter object to apply when retrieving collector versions. This parameter is part of a mutually exclusive parameter set. .PARAMETER TopVersions Switch to retrieve only the top versions of collectors. This parameter is part of a mutually exclusive parameter set. .PARAMETER BatchSize The number of results to return per request. Must be between 1 and 1000. Defaults to 1000. .EXAMPLE #Retrieve all collector versions Get-LMCollectorVersions .EXAMPLE #Retrieve only top versions Get-LMCollectorVersions -TopVersions .NOTES You must run Connect-LMAccount before running this command. .INPUTS None. You cannot pipe objects to this command. .OUTPUTS Returns an array of collector version objects. #> function Get-LMCollectorVersion { [CmdletBinding(DefaultParameterSetName = 'All')] [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSReviewUnusedParameter', '', Justification = 'Required for the TopVersions to work')] param ( [Parameter(ParameterSetName = 'Filter')] [Object]$Filter, [Parameter(ParameterSetName = 'Top')] [Switch]$TopVersions, [ValidateRange(1, 1000)] [Int]$BatchSize = 1000 ) #Check if we are logged in and have valid api creds if ($Script:LMAuth.Valid) { #Build header and uri $ResourcePath = "/setting/collector/collectors/versions" #Initalize vars $QueryParams = "" $Count = 0 $Done = $false $Results = @() #Loop through requests while (!$Done) { #Build query params switch ($PSCmdlet.ParameterSetName) { "All" { $QueryParams = "?size=$BatchSize&offset=$Count&sort=+id" } "Top" { $QueryParams = "?topVersions=true&size=$BatchSize&offset=$Count&sort=+id" } "Filter" { #List of allowed filter props $PropList = @() $ValidFilter = Format-LMFilter -Filter $Filter -PropList $PropList $QueryParams = "?filter=$ValidFilter&size=$BatchSize&offset=$Count&sort=+id" } } $Headers = New-LMHeader -Auth $Script:LMAuth -Method "GET" -ResourcePath $ResourcePath $Uri = "https://$($Script:LMAuth.Portal).$(Get-LMPortalURI)" + $ResourcePath + $QueryParams Resolve-LMDebugInfo -Url $Uri -Headers $Headers[0] -Command $MyInvocation #Issue request $Response = Invoke-LMRestMethod -CallerPSCmdlet $PSCmdlet -Uri $Uri -Method "GET" -Headers $Headers[0] -WebSession $Headers[1] #Stop looping if single device, no need to continue if ($PSCmdlet.ParameterSetName -eq "Id") { $Done = $true return $Response } #Check result size and if needed loop again else { [Int]$Total = $Response.Total [Int]$Count += ($Response.Items | Measure-Object).Count $Results += $Response.Items if ($Count -ge $Total) { $Done = $true } } } return $Results } else { Write-Error "Please ensure you are logged in before running any commands, use Connect-LMAccount to login and try again." } } |