Public/Risk/Get-SCARiskProgress.ps1
|
function Get-SCARiskProgress { <# .SYNOPSIS Gets standing-privilege risk reduction progress over time. .DESCRIPTION Calls GET /risk-posture/secure-standing-privilege/progress on the Risk Management API to return the tenant's historical risk metric trend. .PARAMETER Session A psSCA.Session object or session name. Defaults to the current default session. .EXAMPLE Get-SCARiskProgress | Export-Csv risk-progress.csv -NoTypeInformation Exports the risk progress trend for reporting. .INPUTS None. .OUTPUTS psSCA.RiskProgress .LINK https://api-docs.cyberark.com/risk-management-api/docs/risk-management-api #> [CmdletBinding()] [OutputType('psSCA.RiskProgress')] param( [Parameter()] [object]$Session ) Invoke-SCARequest -Session $Session -Service 'Compass' -Method GET -Path '/risk-posture/secure-standing-privilege/progress' ` -Operation 'Get-SCARiskProgress' -TypeName 'psSCA.RiskProgress' } |