Reset-SecretStore
Redefine o SecretStore excluindo todos os dados secretos e configurando o armazenamento com opções padrão.
Sintaxe
Default (Predefinição)
Reset-SecretStore
[-Scope <SecureStoreScope>]
[-Authentication <Authenticate>]
[-Password <SecureString>]
[-PasswordTimeout <Int32>]
[-Interaction <Interaction>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrição
Importante
A equipa PowerShell decidiu que os módulos Secret são completos em funcionalidades e deixarão de ser 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 foi 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 palavra-passe, como chaves de acesso, login único e sistemas federados de credenciais, como o 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 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 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 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. A especificação None pode ser útil para testar cenários, mas não deve ser usada com segredos importantes.
Propriedades dos parâmetros
| Tipo: | Microsoft.PowerShell.SecretStore.Authenticate |
| Valor predefinido: | Password |
| Valores aceites: | None, Password |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Valor predefinido: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Valor predefinido: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | Microsoft.PowerShell.SecretStore.Interaction |
| Valor predefinido: | Prompt |
| Valores aceites: | None, Prompt |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Valor predefinido: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 Authentication for Password e esse parâmetro não for especificado, o cmdlet solicitará que o usuário insira a senha com segurança.
Propriedades dos parâmetros
| Tipo: | SecureString |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
Propriedades dos parâmetros
| Tipo: | Int32 |
| Valor predefinido: | 900 |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Scope
Especifica o contexto para o qual o SecretStore está configurado. Atualmente, apenas CurrentUser é suportado.
Propriedades dos parâmetros
| Tipo: | Microsoft.PowerShell.SecretStore.SecureStoreScope |
| Valor predefinido: | CurrentUser |
| Valores aceites: | CurrentUser, AllUsers |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Valor predefinido: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.
