Set-EntraUserPasswordProfile

Módulo:
Microsoft.Entra.Users Module v1.3

Establece la contraseña de un usuario.

Sintaxis

Default (valor predeterminado) 

Set-EntraUserPasswordProfile

    [-ForceChangePasswordNextSignIn]
    [-ForceChangePasswordNextSignInWithMfa]
    -UserId <String>
    -Password <SecureString>
    [<CommonParameters>]

Description

El Set-EntraUserPasswordProfile cmdlet con alias Set-EntraUserPassword establece la contraseña de un usuario en Microsoft Entra ID.

Cualquier usuario puede actualizar su contraseña sin pertenecer a ningún rol de administrador.

Ejemplos

Ejemplo 1: Establecer la contraseña de un usuario

Connect-Entra -Scopes 'Directory.AccessAsUser.All'
$newPassword = '<strong-password>'
$securePassword = ConvertTo-SecureString $newPassword -AsPlainText -Force
Set-EntraUserPasswordProfile -UserId 'SawyerM@contoso.com' -Password $securePassword

Este comando establece la contraseña del usuario especificada.

  • -UserIdel parámetro especifica el identificador de un usuario en Microsoft Entra ID.
  • -Password parameter especifica la contraseña que se va a establecer.

Ejemplo 2: Establecer la contraseña de un usuario con el parámetro ForceChangePasswordNextSignInWithMfa

Connect-Entra -Scopes 'Directory.AccessAsUser.All'
$newPassword= '<strong-password>'
$securePassword = ConvertTo-SecureString $newPassword -AsPlainText -Force
Set-EntraUserPasswordProfile -UserId 'SawyerM@contoso.com' -Password $securePassword -ForceChangePasswordNextSignInWithMfa

Este comando establece la contraseña del usuario especificada con el parámetro ForceChangePasswordNextSignInWithMfa.

  • -UserIdel parámetro especifica el identificador de un usuario en Microsoft Entra ID.
  • -Password parameter especifica la contraseña que se va a establecer.
  • -ForceChangePasswordNextSignInWithMfa el parámetro obliga al usuario a cambiar su contraseña.

Ejemplo 3: Establecer la contraseña de un usuario con el parámetro ForceChangePasswordNextSignIn

connect-Entra -Scopes 'Directory.AccessAsUser.All'
$newPassword= '<strong-password>'
$securePassword = ConvertTo-SecureString $newPassword -AsPlainText -Force
Set-EntraUserPasswordProfile -UserId 'SawyerM@contoso.com' -Password $securePassword -ForceChangePasswordNextSignIn

Este comando establece la contraseña del usuario especificada con el parámetro ForceChangePasswordNextSignIn.

  • -UserIdel parámetro especifica el identificador de un usuario en Microsoft Entra ID.
  • -Password parameter especifica la contraseña que se va a establecer.
  • -ForceChangePasswordNextSignIn el parámetro obliga a un usuario a cambiar su contraseña durante el siguiente inicio de sesión.

Parámetros

-ForceChangePasswordNextSignIn

Obliga a un usuario a cambiar su contraseña durante el siguiente inicio de sesión.

Propiedades de parámetro

Tipo:System.Management.Automation.SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
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

-ForceChangePasswordNextSignInWithMfa

Si se establece en true, obligue al usuario a cambiar su contraseña.

Propiedades de parámetro

Tipo:System.Management.Automation.SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
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

-Password

Especifica la contraseña.

Propiedades de parámetro

Tipo:System.SecureString
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-UserId

Especifica el identificador de un usuario.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:ObjectId (identificador de objeto), UPN, Identity, NombrePrincipalDelUsuario

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
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.