Set-EntraUserPasswordProfile

Moduł:
Microsoft.Entra.Users Module v1.3

Ustawia hasło użytkownika.

Składnia

Default (domyślnie) 

Set-EntraUserPasswordProfile

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

Opis

Polecenie Set-EntraUserPasswordProfile cmdlet z aliasem Set-EntraUserPassword ustawia hasło użytkownika w Microsoft Entra ID.

Każdy użytkownik może zaktualizować swoje hasło bez przynależności do żadnej roli administratora.

Przykłady

Przykład 1. Ustawianie hasła użytkownika

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

To polecenie ustawia hasło określonego użytkownika.

  • -UserIdparametr określa identyfikator użytkownika w Microsoft Entra ID.
  • -Password parametr określa hasło do ustawienia.

Przykład 2: Ustawianie hasła użytkownika za pomocą parametru 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

To polecenie ustawia hasło określonego użytkownika za pomocą parametru ForceChangePasswordNextSignInWithMfa.

  • -UserIdparametr określa identyfikator użytkownika w Microsoft Entra ID.
  • -Password parametr określa hasło do ustawienia.
  • -ForceChangePasswordNextSignInWithMfa parametr wymusza zmianę hasła przez użytkownika.

Przykład 3. Ustawianie hasła użytkownika za pomocą parametru 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

To polecenie ustawia hasło określonego użytkownika za pomocą parametru ForceChangePasswordNextSignIn.

  • -UserIdparametr określa identyfikator użytkownika w Microsoft Entra ID.
  • -Password parametr określa hasło do ustawienia.
  • -ForceChangePasswordNextSignIn parametr wymusza, aby użytkownik zmieniał swoje hasło podczas następnego logowania.

Parametry

-ForceChangePasswordNextSignIn

Wymusza zmianę hasła przez użytkownika podczas następnego logowania.

Właściwości parametru

Typ:System.Management.Automation.SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ForceChangePasswordNextSignInWithMfa

W przypadku ustawienia wartości true wymuś zmianę hasła przez użytkownika.

Właściwości parametru

Typ:System.Management.Automation.SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Password

Określa hasło.

Właściwości parametru

Typ:System.SecureString
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-UserId

Określa identyfikator użytkownika.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator Obiektu, nazwa UPN, Identity, NazwaGłównaUżytkownika

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.