Public/System/Get-SCAIntegrationJobStatus.ps1
|
function Get-SCAIntegrationJobStatus { <# .SYNOPSIS Gets the status of a Secure Cloud Access integration job. .DESCRIPTION Calls GET /integrations/status, which reports on asynchronous SCA infrastructure operations such as workspace onboarding or cloud scans. .PARAMETER JobId The job identifier to check. Omit to return the status of the most recent job(s), if the tenant supports that. .PARAMETER Session A psSCA.Session object or session name. Defaults to the current default session. .EXAMPLE Get-SCAIntegrationJobStatus -JobId 'a1b2c3d4-job-id' Gets the status of a specific integration job. .INPUTS None. .OUTPUTS psSCA.IntegrationJobStatus .LINK https://api-docs.cyberark.com/sca-api/docs/secure-cloud-access-apis #> [CmdletBinding()] [OutputType('psSCA.IntegrationJobStatus')] param( [Parameter()] [string]$JobId, [Parameter()] [object]$Session ) Invoke-SCARequest -Session $Session -Service 'SCA' -Method GET -Path '/integrations/status' ` -QueryParameters @{ jobId = $JobId } -Operation 'Get-SCAIntegrationJobStatus' -TypeName 'psSCA.IntegrationJobStatus' } |