Set-SecretStoreConfiguration
Configura o SecretStore.
Sintaxe
ParameterSet (Default)
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>]
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 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 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 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 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 |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ParameterSet
| 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 |
-Default
Indica que o SecretStore deve ser definido como sua configuração padrão.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DefaultParameterSet
| 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: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ParameterSet
| 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 atualizá-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 necessária para acessar o SecretStore. Esse 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 de autenticação de None para Password, o valor desse parâmetro é definido como a nova senha do SecretStore.
Quando esse parâmetro é usado com o parâmetro Authenticate para alterar a configuração de autenticação de Password para None, o valor desse parâmetro deve ser a senha atual do SecretStore. Ele é usado para autorizar a alteração de configuração.
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 quantos segundos o SecretStore permanece desbloqueado após a autenticação com uma senha. Depois que o tempo limite tiver decorrido, o valor da senha atual será 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: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ParameterSet
| 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: | None |
| Valores aceitos: | CurrentUser, AllUsers |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ParameterSet
| 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.
