Compartilhar via


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.

Entradas

Microsoft.PowerShell.SecretManagement.SecretVaultInfo

Saídas

None