Set-EntraUserPasswordProfile

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

Define a palavra-passe de um utilizador.

Sintaxe

Default (Predefinição) 

Set-EntraUserPasswordProfile

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

Descrição

O Set-EntraUserPasswordProfile cmdlet com alias Set-EntraUserPassword define a palavra-passe para um utilizador no Microsoft Entra ID.

Qualquer utilizador pode atualizar a sua palavra-passe sem pertencer a qualquer função de administrador.

Exemplos

Exemplo 1: Definir a palavra-passe de um utilizador

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 define a palavra-passe do utilizador especificado.

  • -UserIdO parâmetro especifica o ID de um utilizador no Microsoft Entra ID.
  • -Password O parâmetro especifica a palavra-passe a definir.

Exemplo 2: Definir a palavra-passe de um utilizador com o parâmetro ForceChangePasswordNextLogInWithMfa

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 define a palavra-passe especificada do utilizador com o parâmetro ForceChangePasswordNextLogInWithMfa.

  • -UserIdO parâmetro especifica o ID de um utilizador no Microsoft Entra ID.
  • -Password O parâmetro especifica a palavra-passe a definir.
  • -ForceChangePasswordNextSignInWithMfa O parâmetro obriga o utilizador a mudar a sua palavra-passe.

Exemplo 3: Definir a palavra-passe do utilizador com o parâmetro ForceChangePasswordNextLogIn

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 define a palavra-passe especificada do utilizador com o parâmetro ForceChangePasswordNextLogin.

  • -UserIdO parâmetro especifica o ID de um utilizador no Microsoft Entra ID.
  • -Password O parâmetro especifica a palavra-passe a definir.
  • -ForceChangePasswordNextSignIn O parâmetro obriga um utilizador a alterar a sua palavra-passe no próximo login.

Parâmetros

-ForceChangePasswordNextSignIn

Obriga um utilizador a mudar a palavra-passe no próximo início de sessão.

Propriedades dos parâmetros

Tipo:System.Management.Automation.SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ForceChangePasswordNextSignInWithMfa

Se estiver definido como verdadeiro, obrigue o utilizador a mudar a palavra-passe.

Propriedades dos parâmetros

Tipo:System.Management.Automation.SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Password

Especifica a palavra-passe.

Propriedades dos parâmetros

Tipo:System.SecureString
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-UserId

Especifica o ID de um utilizador.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:IdentificadorDoObjeto, UPN, Identidade, Nome Principal do Utilizador

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.