Set-SecretStoreConfiguration
Configura o SecretStore.
Sintaxe
ParameterSet (Predefinição)
Set-SecretStoreConfiguration
[-Scope <SecureStoreScope>]
[-Authentication <Authenticate>]
[-PasswordTimeout <Int32>]
[-Interaction <Interaction>]
[-Password <SecureString>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
DefaultParameterSet
Set-SecretStoreConfiguration
[-Default]
[-Password <SecureString>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrição
Important
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.
Este cmdlet configura o SecretStore para o usuário atual.
Exemplos
Exemplo 1
PS C:\> Set-SecretStoreConfiguration -Default
Confirm
Are you sure you want to perform this action?
Performing the operation "Changes local store configuration" on target "SecretStore module local store".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y
Scope Authentication PasswordTimeout Interaction
----- -------------- --------------- -----------
CurrentUser Password 900 Prompt
Este exemplo restaura o SecretStore para sua configuração 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 |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ParameterSet
| 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 |
-Default
Indica que o SecretStore deve ser definido como sua configuração padrão.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Valor predefinido: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
DefaultParameterSet
| 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: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ParameterSet
| 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 atualizá-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 necessária para acessar o SecretStore. Este parâmetro não pode ser usado para alterar a senha existente. Para alterar a senha existente, use Set-SecretStorePassword.
Quando esse parâmetro é usado com o parâmetro Authenticate para alterar a configuração para autenticação de None para Password, o valor desse parâmetro é definido como a nova senha para o SecretStore.
Quando esse parâmetro é usado com o parâmetro Authenticate para alterar a configuração para autenticação de Password para None, o valor desse parâmetro deve ser a senha atual para o SecretStore. Ele é usado para autorizar a alteração de configuração.
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 quantos segundos o SecretStore permanece desbloqueado após a autenticação com uma senha. Após o tempo limite, 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: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ParameterSet
| 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: | None |
| Valores aceites: | CurrentUser, AllUsers |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
ParameterSet
| 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.
