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.

Entradas

None

Salidas

None