Find-HXBulkAcquisition.ps1
function Find-HXBulkAcquisition { [CmdletBinding()] [OutputType([psobject])] param( [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true)] [string] $Uri, [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true)] [Microsoft.PowerShell.Commands.WebRequestSession] $WebSession, [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true)] [string] $TokenSession, [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true)] [string] $Search, [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true)] [string] $Offset, [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true)] [string] $Limit, [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true)] [string] $Sort, [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true)] [string] $Filter, [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true)] [Alias("hostset_id")] [string] $HostSetId, [Parameter(Mandatory=$false, ValueFromPipelineByPropertyName=$true)] [string] $HostSet, [Parameter(Mandatory=$false)] [switch] $Passthru, [Parameter(Mandatory=$false)] [switch] $Raw ) begin { } process { # Uri filtering: if ($Uri -match '\d$') { $Endpoint = $Uri+'/hx/api/v3/acqs/bulk/?' } elseif ($Uri -match '\d/$') { $Endpoint = $Uri+'hx/api/v3/acqs/bulk?' } else { $Endpoint = $Uri + "/?" } # Header: $headers = @{ "Accept" = "application/json" } if (-not($WebSession) -and ($TokenSession)) { $headers += @{ "X-FeApi-Token" = $TokenSession } } # Enable auto-search by a given host-set id: if (($HostsetId) -and (-not($Search))) { $Search = $HostsetId } if ($Search) { $Endpoint = $Endpoint + "&search=" + $Search } if ($Offset) { $Endpoint = $Endpoint + "&offset=" + $Offset } if ($Limit) { $Endpoint = $Endpoint + "&limit=" + $Limit } if ($Sort) { $Endpoint = $Endpoint + "&sort=" + $Sort } if ($Filter) { $Endpoint = $Endpoint + "&" + $Filter } # Request: $WebRequest = Invoke-WebRequest -Uri $Endpoint -WebSession $WebSession -Method Get -Headers $headers -SkipCertificateCheck $WebRequestContent = $WebRequest.Content | ConvertFrom-Json # Return the object: if (-not($Raw)) { $WebRequestContent.data.entries | Foreach-Object { $out = New-Object System.Object $out | Add-Member -Type NoteProperty -Name bulkacquisition_id -Value $_._id if ($Hostset) { $out | Add-Member -Type NoteProperty -Name hostset -Value $Hostset } $out | Add-Member -Type NoteProperty -Name revision -Value $_._revision $out | Add-Member -Type NoteProperty -Name comment -Value $_.comment $out | Add-Member -Type NoteProperty -Name create_actor_id -Value $_.create_actor._id $out | Add-Member -Type NoteProperty -Name create_actor_username -Value $_.create_actor.username $out | Add-Member -Type NoteProperty -Name create_time -Value $_.create_time $out | Add-Member -Type NoteProperty -Name update_actor_id -Value $_.update_actor._id $out | Add-Member -Type NoteProperty -Name update_actor_username -Value $_.update_actor.username $out | Add-Member -Type NoteProperty -Name update_time -Value $_.update_time $out | Add-Member -Type NoteProperty -Name state -Value $_.state $out | Add-Member -Type NoteProperty -Name url -Value $_.url $out | Add-Member -Type NoteProperty -Name running_state -Value $_.stats.running_state # Check if login data is required to be passed thru: if ($Passthru) { $out | Add-Member -Type NoteProperty -Name Uri -Value $Uri if ($WebSession) { $out | Add-Member -Type NoteProperty -Name WebSession -Value $WebSession } if ($TokenSession) { $out | Add-Member -Type NoteProperty -Name TokenSession -Value $TokenSession } } $out } } else { $WebRequestContent.data.entries | Foreach-Object { $out = New-Object System.Object $out | Add-Member -Type NoteProperty -Name Uri -Value $Uri $out | Add-Member -Type NoteProperty -Name Endpoint -Value $Endpoint $out | Add-Member -Type NoteProperty -Name WebSession -Value $WebSession $out | Add-Member -Type NoteProperty -Name TokenSession -Value $TokenSession $out | Add-Member -Type NoteProperty -Name RequestStatusCode -Value $WebRequest.StatusCode $out | Add-Member -Type NoteProperty -Name RequestContent -Value $_ $out } } } end { } } |