Functions/Accounts/Remove-PASAccount.ps1
|
# .ExternalHelp psPAS-help.xml function Remove-PASAccount { [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSReviewUnusedParameter', 'UseGen1API', Justification = 'False Positive')] [CmdletBinding(SupportsShouldProcess, DefaultParameterSetName = 'Default')] param( [parameter( Mandatory = $true, ValueFromPipelinebyPropertyName = $true )] [ValidateNotNullOrEmpty()] [Alias('id')] [string]$AccountID, [parameter( Mandatory = $false, ValueFromPipelinebyPropertyName = $false, ParameterSetName = 'Gen1' )] [Alias('UseClassicAPI')] [switch]$UseGen1API, [parameter( Mandatory = $false, ValueFromPipelinebyPropertyName = $true, ParameterSetName = 'Default' )] [boolean]$DeleteSSHKey ) begin { #check minimum version Assert-VersionRequirement -RequiredVersion 10.4 }#begin process { switch ($PSCmdlet.ParameterSetName) { 'Gen1' { #Create URL for request (earlier than 10.4) $URI = "$($psPASSession.BaseURI)/WebServices/PIMServices.svc/Accounts/$AccountID" break } default { #Create URL for request (Version 10.4 onwards) $URI = "$($psPASSession.BaseURI)/api/Accounts/$AccountID" if ($PSBoundParameters.ContainsKey('DeleteSSHKey')) { if (Test-IsISPSS) { #Privilege Cloud parameter name $QueryParameters = @{'deleteOnlyPrivateSshKey' = $DeleteSSHKey } } else { #Self-Hosted parameter name, requires 15.2 Assert-VersionRequirement -RequiredVersion 15.2 $QueryParameters = @{'deleteSshKeyFromVaultAndTarget' = $DeleteSSHKey } } $queryString = $QueryParameters | ConvertTo-QueryString if ($null -ne $queryString) { #Build URL from base URL $URI = "$URI`?$queryString" } } } } if ($PSCmdlet.ShouldProcess($AccountID, 'Delete Account')) { #Send request to webservice Invoke-PASRestMethod -Uri $URI -Method DELETE } }#process end { }#end } |