Unregister-SecretVault
Cancela o registro de um cofre de extensões 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
Esse cmdlet cancela o registro do cofre de extensão especificado. Depois de 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 de LocalStore. O terceiro comando verifica se o cofre não aparece mais no registro.
O quarto comando tenta recuperar Secret5, mas não é encontrado, pois seu cofre não foi registrado. O quinto comando registra novamente o cofre em 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. Por fim, 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 por meio do pipeline para Unregister-SecretVault.
Get-SecretVault mostra que o segredo não existe mais no cofre.
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Especifica o nome do cofre para cancelar o registro. Insira um nome ou um padrão de nome. Caracteres curinga (*) são permitidos.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
NameParameterSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SecretVault
Especifica um objeto SecretVaultInfo que representa o cofre a ser desinstalado.
Propriedades do parâmetro
| Tipo: | Microsoft.PowerShell.SecretManagement.SecretVaultInfo |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
SecretVaultParameterSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.