Unregister-SecretVault
Cancela o registro de um cofre de extensão do SecretManagement para o usuário atual.
Sintaxe
NameParameterSet
Unregister-SecretVault
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecretVaultParameterSet
Unregister-SecretVault
[-SecretVault] <SecretVaultInfo>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Este cmdlet cancela o registro do cofre de extensão especificado. Uma vez não registrado, o cofre não estará mais disponível para SecretManagement para o usuário atual.
Exemplos
Exemplo 1
PS C:\> Get-SecretVault
VaultName ModuleName IsDefaultVault
--------- ---------- --------------
CredMan Microsoft.PowerShell.CredManStore False
LocalStore Microsoft.PowerShell.SecretStore True
PS C:\> Unregister-SecretVault LocalStore
PS C:\> Get-SecretVault
VaultName ModuleName IsDefaultVault
--------- ---------- --------------
CredMan Microsoft.PowerShell.CredManStore False
PS C:\> Get-Secret -Name Secret5
Get-Secret: The secret Secret5 wasn't found.
PS C:\> Register-SecretVault -Name SecretStore -ModuleName Microsoft.PowerShell.SecretStore -DefaultVault
PS C:\> Get-SecretVault
VaultName ModuleName IsDefaultVault
--------- ---------- --------------
CredMan Microsoft.PowerShell.CredManStore False
SecretStore Microsoft.PowerShell.SecretStore True
PS C:\> Get-Secret -Name Secret5
System.Security.SecureString
O primeiro comando lista os cofres registrados para o usuário atual. O segundo comando cancela o registro do cofre LocalStore. O terceiro comando verifica se o cofre não aparece mais no registro.
O quarto comando tenta recuperar Secret5, mas não é encontrado desde que seu cofre não foi registrado. O quinto comando registra novamente o cofre com um nome diferente e o define como o cofre padrão do usuário. O sexto comando verifica se o cofre foi registrado novamente como SecretStore e é o cofre padrão. Finalmente, o último comando recupera Secret5 do cofre registrado novamente.
Exemplo 2
PS C:\> Get-SecretVault | Unregister-SecretVault
PS C:\> Get-SecretVault
Este exemplo cancela o registro de todos os cofres de extensão para o usuário atual. O segundo comando mostra que nenhum cofre está registrado.
Este exemplo cancela o registro de todos os cofres de extensão para o usuário atual.
Get-SecretVault recupera todos os cofres registrados para o usuário atual e envia o resultado através do pipeline para Unregister-SecretVault.
Get-SecretVault mostra que o segredo não existe mais no cofre.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
Especifica o nome do cofre para cancelar o registro. Insira um nome ou padrão de nome. Caracteres coringa (*) são permitidos.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | True |
| NãoMostrar: | False |
Conjuntos de parâmetros
NameParameterSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-SecretVault
Especifica um SecretVaultInfo objeto que representa o vault para cancelar o registro.
Propriedades dos parâmetros
| Tipo: | Microsoft.PowerShell.SecretManagement.SecretVaultInfo |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
SecretVaultParameterSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.