Set-EntraUserPasswordProfile

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

Define a senha de um usuário.

Sintaxe

Default (Default) 

Set-EntraUserPasswordProfile

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

Description

O Set-EntraUserPasswordProfile cmdlet com alias Set-EntraUserPassword define a senha de um usuário em Microsoft Entra ID.

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

Exemplos

Exemplo 1: Definir a senha de um usuário

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

Esse comando define a senha do usuário especificado.

  • -UserIdO parâmetro especifica a ID de um usuário no Microsoft Entra ID.
  • -Password o parâmetro especifica a senha a ser definida.

Exemplo 2: Definir a senha de um usuário com o 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

Esse comando define a senha do usuário especificado com o parâmetro ForceChangePasswordNextSignInWithMfa.

  • -UserIdO parâmetro especifica a ID de um usuário no Microsoft Entra ID.
  • -Password o parâmetro especifica a senha a ser definida.
  • -ForceChangePasswordNextSignInWithMfa o parâmetro força o usuário a alterar sua senha.

Exemplo 3: Definir a senha de um usuário com o 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

Esse comando define a senha do usuário especificado com o parâmetro ForceChangePasswordNextSignIn.

  • -UserIdO parâmetro especifica a ID de um usuário no Microsoft Entra ID.
  • -Password o parâmetro especifica a senha a ser definida.
  • -ForceChangePasswordNextSignIn o parâmetro força um usuário a alterar sua senha durante o próximo logon.

Parâmetros

-ForceChangePasswordNextSignIn

Força um usuário a alterar sua senha durante a próxima entrada.

Propriedades do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ForceChangePasswordNextSignInWithMfa

Se definido como true, force o usuário a alterar sua senha.

Propriedades do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Password

Especifica a senha.

Propriedades do parâmetro

Tipo:System.SecureString
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-UserId

Especifica a ID de um usuário.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:IdentificadorDeObjeto, UPN, Identidade, Nome Principal do Usuário

Conjuntos de parâmetros

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