Set-EntraUserPasswordProfile

Modul:
Microsoft.Entra.Users Module v1.3

Legt das Kennwort eines Benutzers fest.

Syntax

Default (Standard) 

Set-EntraUserPasswordProfile

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

Beschreibung

Das Set-EntraUserPasswordProfile Cmdlet mit Alias Set-EntraUserPassword legt das Kennwort für einen Benutzer in Microsoft Entra ID fest.

Jeder Benutzer kann sein Kennwort aktualisieren, ohne zu einer Administratorrolle zu gehören.

Beispiele

Beispiel 1: Festlegen des Kennworts eines Benutzers

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

Mit diesem Befehl wird das Kennwort des angegebenen Benutzers festgelegt.

  • -UserIdder Parameter gibt die ID eines Benutzers in Microsoft Entra ID an.
  • -Password der Parameter gibt das festzulegende Kennwort an.

Beispiel 2: Festlegen des Kennworts eines Benutzers mit dem Parameter "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

Mit diesem Befehl wird das Kennwort des angegebenen Benutzers mit dem Parameter ForceChangePasswordNextSignInWithMfa festgelegt.

  • -UserIdder Parameter gibt die ID eines Benutzers in Microsoft Entra ID an.
  • -Password der Parameter gibt das festzulegende Kennwort an.
  • -ForceChangePasswordNextSignInWithMfa parameter erzwingt, dass der Benutzer sein Kennwort ändert.

Beispiel 3: Festlegen des Kennworts eines Benutzers mit dem Parameter "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

Mit diesem Befehl wird das Kennwort des angegebenen Benutzers mit dem Parameter ForceChangePasswordNextSignIn festgelegt.

  • -UserIdder Parameter gibt die ID eines Benutzers in Microsoft Entra ID an.
  • -Password der Parameter gibt das festzulegende Kennwort an.
  • -ForceChangePasswordNextSignIn der Parameter zwingt einen Benutzer, sein Kennwort während der nächsten Anmeldung zu ändern.

Parameter

-ForceChangePasswordNextSignIn

Erzwingt, dass ein Benutzer sein Kennwort während der nächsten Anmeldung ändert.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ForceChangePasswordNextSignInWithMfa

Wenn dieser Wert auf "true" festgelegt ist, erzwingen Sie, dass der Benutzer sein Kennwort ändert.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Password

Gibt das Kennwort an.

Parametereigenschaften

Typ:System.SecureString
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-UserId

Gibt die ID eines Benutzers an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Objekt-ID, UPN (Benutzerprinzipalname), Identity, Benutzerhauptname

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.