Public/Resources/Remove-SIADatabaseStrongAccount.ps1
|
function Remove-SIADatabaseStrongAccount { <# .SYNOPSIS Deletes a database strong account from SIA. .DESCRIPTION Permanently removes a database strong account. This does not affect the underlying database account itself. .PARAMETER Id The database strong account's ID, as returned by Get-SIADatabaseStrongAccount. .EXAMPLE Remove-SIADatabaseStrongAccount -Id 'db-secret-01' Deletes the specified database strong account after confirmation. .INPUTS psSIA.DatabaseStrongAccount .OUTPUTS None. .LINK https://api-docs.cyberark.com/secure-infra-access/docs/strong-account-apis-for-sia-databases #> [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'High')] param( [Parameter(Mandatory, ValueFromPipelineByPropertyName)] [Alias('strong_account_id')] [string]$Id ) process { if ($PSCmdlet.ShouldProcess($Id, 'Delete database strong account')) { Invoke-SIARequest -Method DELETE -Path "/api/database-strong-accounts/$Id" | Out-Null } } } |