Set-SecretStoreConfiguration
Configura el secretStore de.
Sintaxis
ParameterSet (valor predeterminado)
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
El equipo de PowerShell ha decidido que los módulos Secret son completos en funciones y que ya no se desarrollarán activamente. Los módulos seguirán siendo compatibles con la seguridad y la corrección de errores críticos. El repositorio de código ha sido archivado.
Las últimas versiones publicadas son:
La naturaleza de los secretos ha cambiado fundamentalmente desde que se diseñó este proyecto. Los métodos de autenticación sin contraseña como las llaves de acceso, el inicio de sesión único y los sistemas federados de credenciales como Microsoft Entra ID, biometría y claves de seguridad hardware son el futuro.
Este cmdlet configura el SecretStore para el usuario actual.
Ejemplos
Ejemplo 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
En este ejemplo se restaura el secretStore de a su configuración predeterminada.
Parámetros
-Authentication
Especifica cómo autenticar el acceso a la de SecretStore de. El valor debe ser Password o None.
Si se especifica como None, el cmdlet habilita el acceso a la secretStore de sin contraseña. La autenticación predeterminada es Password.
Precaución
Establecer el de autenticación de en None es menos seguro que Password. La especificación None puede ser útil para probar escenarios, pero no se debe usar con secretos importantes.
Propiedades de parámetro
| Tipo: | Microsoft.PowerShell.SecretStore.Authenticate |
| Valor predeterminado: | Password |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParameterSet
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Default
Indica que el SecretStore debe establecerse en su configuración predeterminada.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
DefaultParameterSet
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Interaction
Especifica si el SecretStore debe preguntar a un usuario cuando acceda a él. Si el valor es Prompt, se solicita al usuario su contraseña en sesiones interactivas cuando sea necesario. Si el valor es None, no se le pide al usuario una contraseña. Si el valor es None y se requiere una contraseña, el cmdlet que requiere la contraseña produce un error Microsoft.PowerShell.SecretStore.PasswordRequiredException error.
Propiedades de parámetro
| Tipo: | Microsoft.PowerShell.SecretStore.Interaction |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParameterSet
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PassThru
Indica que el cmdlet debe devolver la configuración de SecretStore después de actualizarlo. De forma predeterminada, el cmdlet no devuelve ninguna salida.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Password
Especifica la contraseña necesaria para acceder al SecretStore. Este parámetro no se puede usar para cambiar la contraseña existente. Para cambiar la contraseña existente, use Set-SecretStorePassword.
Cuando este parámetro se usa con el parámetro Authenticate para cambiar la configuración de autenticación de None a Password, el valor de este parámetro se establece como la nueva contraseña del SecretStore.
Cuando este parámetro se usa con el parámetro Authenticate para cambiar la configuración de autenticación de Password a None, el valor de este parámetro debe ser la contraseña actual del SecretStore. Se utiliza para autorizar el cambio de configuración.
Propiedades de parámetro
| Tipo: | SecureString |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PasswordTimeout
Especifica cuántos segundos el secretStore de permanece desbloqueado después de autenticarse con una contraseña. Una vez transcurrido el tiempo de espera, el valor de contraseña actual se invalida para la sesión. Acceso a la secretStore de después de que el tiempo de espera requiera la contraseña de nuevo.
Propiedades de parámetro
| Tipo: | Int32 |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParameterSet
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Scope
Especifica el contexto para el que se configura el SecretStore. Actualmente solo se admite CurrentUser.
Propiedades de parámetro
| Tipo: | Microsoft.PowerShell.SecretStore.SecureStoreScope |
| Valor predeterminado: | None |
| Valores aceptados: | CurrentUser, AllUsers |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParameterSet
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
