Reset-SecretStore
Redefine o SecretStore excluindo todos os dados secretos e configurando o repositório com opções padrão.
Sintaxe
Default (Default)
Reset-SecretStore
[-Scope <SecureStoreScope>]
[-Authentication <Authenticate>]
[-Password <SecureString>]
[-PasswordTimeout <Int32>]
[-Interaction <Interaction>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Importante
A equipe do PowerShell decidiu que os módulos Secret são completos em recursos e não serão mais desenvolvidos ativamente. Os módulos continuarão a ser suportados para correções de segurança e bugs críticos. O repositório de código será arquivado.
As versões mais recentes publicadas são:
A natureza dos segredos mudou fundamentalmente desde que este projeto foi concebido. Métodos de autenticação sem senha, como chaves de acesso, login único e sistemas federados de credenciais, como Microsoft Entra ID, biometria e chaves de segurança de hardware, são o futuro.
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 apenas se uma senha necessária for perdida ou se 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 habilita o acesso ao SecretStore sem uma senha. A autenticação padrão é Password.
Cuidado
Definir o de Autenticação para None é menos seguro do que Password. A especificação None pode ser útil para cenários de teste, mas não deve ser usada com segredos importantes.
Propriedades do parâmetro
| Tipo: | Microsoft.PowerShell.SecretStore.Authenticate |
| Valor padrão: | Password |
| Valores aceitos: | None, Password |
| Dá suporte a curingas: | False |
| DontShow: | False |
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 |
-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 |
-Force
Indica que o cmdlet deve redefinir o SecretStore sem solicitar. Por padrão, o cmdlet alerta sobre o impacto da redefinição do SecretStore e solicita confirmação ao usuário.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
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 |
-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.
Propriedades do parâmetro
| Tipo: | Microsoft.PowerShell.SecretStore.Interaction |
| Valor padrão: | Prompt |
| Valores aceitos: | None, Prompt |
| Dá suporte a curingas: | False |
| DontShow: | False |
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 |
-PassThru
Indica que o cmdlet deve retornar a configuração do SecretStore depois de redefini-lo. Por padrão, o cmdlet não retorna nenhuma saída.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
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 |
-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 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.
Propriedades do parâmetro
| Tipo: | SecureString |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
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 |
-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.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | 900 |
| Dá suporte a curingas: | False |
| DontShow: | False |
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 |
-Scope
Especifica o contexto para o qual o SecretStore está configurado. No momento, há suporte apenas CurrentUser.
Propriedades do parâmetro
| Tipo: | Microsoft.PowerShell.SecretStore.SecureStoreScope |
| Valor padrão: | CurrentUser |
| Valores aceitos: | CurrentUser, AllUsers |
| Dá suporte a curingas: | False |
| DontShow: | False |
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 |
-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.
