Public/Policies/Remove-SIAAccessPolicy.ps1
|
function Remove-SIAAccessPolicy { <# .SYNOPSIS Deletes a legacy SIA VM access policy. .DESCRIPTION Deletes a policy from SIA's original "Recurring access policies" engine. Only applies to tenants still on that engine; see docs/API-COMPATIBILITY.md. .PARAMETER Id The policy's ID, as returned by Get-SIAAccessPolicy. .EXAMPLE Remove-SIAAccessPolicy -Id 'policy-01' Deletes the specified legacy access policy after confirmation. .INPUTS psSIA.AccessPolicy .OUTPUTS None. .LINK https://docs.cyberark.com/setup/latest/en/content/privileged-access/apis/dpa_policies.htm #> [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'High')] param( [Parameter(Mandatory, ValueFromPipelineByPropertyName)] [Alias('policy_id')] [string]$Id ) process { if ($PSCmdlet.ShouldProcess($Id, 'Delete legacy access policy')) { Invoke-SIARequest -Method DELETE -Path "/api/access-policies/$Id" | Out-Null } } } |