Partilhar via


Reset-SecretStore

Redefine o SecretStore excluindo todos os dados secretos e configurando o armazenamento com opções padrão.

Sintaxe

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 possa conter e redefinindo as opções de configuração para seus valores padrão. Destina-se a ser usado apenas se uma senha necessária for perdida ou os arquivos de dados forem corrompidos para que 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 individuais de opção de configuração de comando.

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 avisa sobre as consequências dessa ação e solicita a confirmação do usuário antes de continuar. Após a confirmação, o cmdlet exclui todos os segredos e define cada definição de configuração com 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 permite o acesso ao SecretStore sem uma senha. A autenticação padrão é Password.

Atenção

Definir o de Autenticação como None é menos seguro do que Password. Especificar None pode ser útil para testar cenários, mas não deve ser usado com segredos importantes.

Tipo:Authenticate
Valores aceites:None, Password
Position:Named
Default value:Password
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

Indica que o cmdlet deve redefinir o SecretStore sem solicitar. Por padrão, o cmdlet avisa sobre o impacto da redefinição do SecretStore e solicita a confirmação do usuário.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Interaction

Especifica se o SecretStore deve avisar um usuário quando ele acessá-lo. 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, não será solicitada uma senha ao usuário. Se o valor for None e uma senha for necessária, o cmdlet que requer a senha lançará um erro Microsoft.PowerShell.SecretStore.PasswordRequiredException.

Tipo:Interaction
Valores aceites:None, Prompt
Position:Named
Default value:Prompt
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PassThru

Indica que o cmdlet deve retornar a configuração SecretStore depois de redefini-la. Por padrão, o cmdlet não retorna nenhuma saída.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Password

Especifica a senha que o SecretStore deve exigir para acesso. Se de Autenticação for especificado como None, o cmdlet retornará um erro. Se de Autenticação estiver Password e esse parâmetro não for especificado, o cmdlet solicitará que o usuário insira a senha com segurança.

Tipo:SecureString
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PasswordTimeout

Especifica por quanto tempo o SecretStore permanece desbloqueado após a autenticação com uma senha. Quando o valor de tempo limite é atingido, o valor da senha atual é invalidado para a sessão. O acesso ao SecretStore após o tempo limite requer a senha novamente.

Tipo:Int32
Position:Named
Default value:900
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Scope

Especifica o contexto para o qual o SecretStore está configurado. Atualmente, apenas CurrentUser é suportado.

Tipo:SecureStoreScope
Valores aceites:CurrentUser, AllUsers
Position:Named
Default value:CurrentUser
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

Microsoft.PowerShell.SecretStore.SecureStoreConfig