Remove-PSUSecretVault

Remove a model-backed PowerShell Universal secret vault registration.

SYNOPSIS

Removes a model-backed secret vault registration.

SYNTAX

Remove-PSUSecretVault -Id <Int64> [<ConnectionOptions>] [<CommonParameters>]
Remove-PSUSecretVault -Name <String> [<ConnectionOptions>] [<CommonParameters>]
Remove-PSUSecretVault -Vault <Vault> [<ConnectionOptions>] [<CommonParameters>]

<ConnectionOptions>: [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies].

DESCRIPTION

Removes a configured PowerShell Universal secret vault registration, by ID, name, or vault object from the pipeline. Removing the registration stops PSU from using it; it does not delete the external Azure Key Vault or purge any Azure secrets.

EXAMPLES

Remove-PSUSecretVault -Name 'Production Key Vault'
Get-PSUSecretVault -Name 'Production Key Vault' | Remove-PSUSecretVault

PARAMETERS

Parameter	Description
-Id	Required numeric registration ID (Id parameter set).
-Name	Required registration name (Name parameter set).
-Vault	Required vault object; accepts pipeline input (Vault parameter set).
-ComputerName	PSU Management API URL or host name (alias -Uri).
-AppToken	Management API app token.
-Credential	Management API credentials.
-UseDefaultCredentials	Uses current Windows credentials.
-Integrated	Uses the in-process management client.
-TrustCertificate	Ignores certificate validation errors.
-Cookies	Reuses session authentication cookies.

OUTPUTS

None.

RELATED LINKS

Get-PSUSecretVault · New-PSUSecretVault

PERMISSIONS

The access token requires platform.vaults/delete to remove a vault registration remotely.