Set-SecretStorePassword
Reemplaza la contraseña actual de SecretStore por una nueva.
Sintaxis
NoParameterSet (valor predeterminado)
Set-SecretStorePassword
[<CommonParameters>]
ParameterSet
Set-SecretStorePassword
-NewPassword <SecureString>
[-Password <SecureString>]
[<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 actualiza la contraseña de SecretStore.
Ejemplos
Ejemplo 1
PS C:\> Set-SecretStorePassword
Old password
Enter password:
*******
New password
Enter password:
*******
Enter password again for verification:
*******
En este ejemplo se ejecuta el comando sin argumentos de parámetro. El usuario se solicita por primera vez la contraseña antigua. Y, a continuación, se le pedirá la nueva contraseña dos veces para la comprobación.
Ejemplo 2
PS C:\> Set-SecretStorePassword -NewPassword $newPassword -Password $oldPassword
En este ejemplo se ejecuta el comando que pasa la contraseña del almacén actual y la nueva contraseña que se va a establecer.
Parámetros
-NewPassword
Especifica la nueva contraseña para acceder al SecretStore. Si no se especifica este parámetro y el cmdlet se ejecuta en una sesión interactiva, solicita al usuario el valor. Si no se especifica este parámetro y el cmdlet se ejecuta en una sesión no interactiva, devuelve un error.
Propiedades de parámetro
| Tipo: | SecureString |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParameterSet
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Password
Contraseña existente necesaria para desbloquear el almacén. Esto se puede omitir si el almacén no usa actualmente una contraseña.
Especifica la contraseña existente para acceder al SecretStore. Si SecretStore no está configurado para requerir una contraseña, este parámetro se omite.
Si SecretStore está configurado para requerir una contraseña, no se especifica este parámetro y el cmdlet se ejecuta en una sesión interactiva, solicita al usuario el valor. Si SecretStore está configurado para requerir una contraseña, este parámetro no se especifica y el cmdlet se ejecuta en una sesión no interactiva, devuelve un error.
Propiedades de parámetro
| Tipo: | SecureString |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ParameterSet
| Posición: | Named |
| Obligatorio: | 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.