Reset-SecretStore
Redefine o SecretStore excluindo todos os dados secretos e configurando o repositório com opções padrão.
Syntax
Reset-SecretStore
[-Scope <SecureStoreScope>]
[-Authentication <Authenticate>]
[-Password <SecureString>]
[-PasswordTimeout <Int32>]
[-Interaction <Interaction>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Esse cmdlet redefine completamente o SecretStore excluindo todos os dados secretos que ele pode conter e redefinindo as opções de configuração para seus valores padrão. Ele deve ser usado somente se uma senha necessária for perdida ou os arquivos de dados forem corrompidos para que o SecretStore não funcione mais e os dados secretos não possam ser acessados.
As opções de configuração padrão podem ser substituídas especificando parâmetros de opção de configuração de comando individuais.
Exemplos
Exemplo 1
PS C:\> Reset-SecretStore -PassThru
WARNING: !!This operation will completely remove all SecretStore module secrets and reset
configuration settings to default values!!
Reset SecretStore
Are you sure you want to erase all secrets in SecretStore and reset configuration settings to default?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): Y
Creating a new Microsoft.PowerShell.SecretStore vault. A password is required by the current store configuration.
Enter password:
********
Enter password again for verification:
********
Scope Authentication PasswordTimeout Interaction
----- -------------- --------------- -----------
CurrentUser Password 900 Prompt
Este exemplo redefine o SecretStore para o usuário atual. O cmdlet alerta sobre as consequências dessa ação e solicita ao usuário a confirmação antes de continuar. Após a confirmação, o cmdlet exclui todos os segredos e define cada configuração como seu valor padrão.
Parâmetros
-Authentication
Especifica como autenticar o acesso ao SecretStore. O valor deve ser Password
ou None
.
Se especificado como None
, o cmdlet habilitará o acesso ao SecretStore sem uma senha. A autenticação padrão é Password
.
Cuidado
Definir a Autenticação como None
é menos seguro que Password
. A especificação None
pode ser útil para cenários de teste, mas não deve ser usada com segredos importantes.
Type: | Authenticate |
Accepted values: | None, Password |
Position: | Named |
Default value: | Password |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Indica que o cmdlet deve redefinir o SecretStore sem avisar. Por padrão, o cmdlet alerta sobre o impacto da redefinição do SecretStore e solicita confirmação ao usuário.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Interaction
Especifica se o SecretStore deve solicitar a um usuário quando ele o acessar. Se o valor for Prompt
, o usuário será solicitado a fornecer sua senha em sessões interativas quando necessário. Se o valor for None
, o usuário não será solicitado a fornecer uma senha. Se o valor for None
e uma senha for necessária, o cmdlet que exige a senha gerará um erro Microsoft.PowerShell.SecretStore.PasswordRequiredException .
Type: | Interaction |
Accepted values: | None, Prompt |
Position: | Named |
Default value: | Prompt |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Indica que o cmdlet deve retornar a configuração do SecretStore após redefini-la. Por padrão, o cmdlet não retorna nenhuma saída.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Password
Especifica a senha que o SecretStore deve exigir para acesso. Se a Autenticação for especificada como None
, o cmdlet retornará um erro. Se a Autenticação for Password
e esse parâmetro não for especificado, o cmdlet solicitará que o usuário insira a senha com segurança.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordTimeout
Especifica por quanto tempo o SecretStore permanece desbloqueado após a autenticação com uma senha. Quando o valor do tempo limite é atingido, o valor da senha atual é invalidado para a sessão. Acessar o SecretStore após o tempo limite requer a senha novamente.
Type: | Int32 |
Position: | Named |
Default value: | 900 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Especifica o contexto para o qual o SecretStore está configurado. Atualmente, há suporte apenas para CurrentUser
.
Type: | SecureStoreScope |
Accepted values: | CurrentUser, AllUsers |
Position: | Named |
Default value: | CurrentUser |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Saídas
Microsoft.PowerShell.SecretStore.SecureStoreConfig