Set-EntraUser

Set-EntraUser

    -UserId <String>
    [-PostalCode <String>]
    [-CompanyName <String>]
    [-GivenName <String>]
    [-Mobile <String>]
    [-PreferredLanguage <String>]
    [-CreationType <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-AgeGroup <String>]
    [-MailNickName <String>]
    [-ExtensionProperty <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
    [-ConsentProvidedForMinor <String>]
    [-ImmutableId <String>]
    [-Country <String>]
    [-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
    [-Department <String>]
    [-StreetAddress <String>]
    [-PasswordPolicies <String>]
    [-JobTitle <String>]
    [-City <String>]
    [-OtherMails <System.Collections.Generic.List`1[System.String]>]
    [-UserPrincipalName <String>]
    [-DisplayName <String>]
    [-AccountEnabled <Boolean>]
    [-PasswordProfile <PasswordProfile>]
    [-State <String>]
    [-TelephoneNumber <String>]
    [-Surname <String>]
    [-ShowInAddressList <Boolean>]
    [<CommonParameters>]

Das Set-EntraUser Cmdlet aktualisiert einen Benutzer in Microsoft Entra ID. Geben Sie den Parameter an, um UserId einen Benutzer in Microsoft Entra ID zu aktualisieren.

Update-EntraUser ist ein Alias für Set-EntraUser.

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraUser -UserId 'SawyerM@contoso.com' -DisplayName 'Updated user Name'

In diesem Beispiel wird der Anzeigename-Parameter des angegebenen Benutzers aktualisiert.

• -UserId Gibt die ID als Benutzerprinzipalnamen (USER Principal Name, UPN) oder UserId an.

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraUser -UserId 'SawyerM@contoso.com' -AccountEnabled $true

In diesem Beispiel wird der AccountEnabled-Parameter des angegebenen Benutzers aktualisiert.

• -UserId Gibt die ID als Benutzerprinzipalnamen (USER Principal Name, UPN) oder UserId an.
• -AccountEnabled Gibt an, ob das Konto aktiviert ist.

Connect-Entra -Scopes 'User.ReadWrite.All'
Get-EntraUser -All | Where-Object -Property DisplayName -Match '(George|James|Education)' |
ForEach-Object { Set-EntraUser -UserId $($_.Id) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }

In diesem Beispiel wird der angegebene Benutzer als Minderjährige mit elterlicher Zustimmung aktualisiert.

• -UserId Gibt die ID als Benutzerprinzipalnamen (USER Principal Name, UPN) oder UserId an.
• -ConsentProvidedForMinor Legt fest, ob die Zustimmung für Minderjährige abgerufen werden muss. Zulässige Werte: NULL, gewährt, verweigert und nicht angefordert.

Connect-Entra -Scopes 'User.ReadWrite.All'
$params = @{
    UserId           = 'SawyerM@contoso.com'
    City             = 'Add city name'
    CompanyName      = 'Microsoft'
    Country          = 'Add country name'
    Department       = 'Add department name'
    GivenName        = 'Sawyer Miller G'
    JobTitle         = 'Manager'
    MailNickName     = 'Add mailnickname'
    Mobile           = '9984534564'
    OtherMails       = 'johndoe@contosodev.com'
    PasswordPolicies = 'DisableStrongPassword'
    State            = 'UP'
    StreetAddress    = 'Add address'
    UserType         = 'Member'
}
Set-EntraUser @params

In diesem Beispiel wird die Eigenschaft des angegebenen Benutzers aktualisiert.

• -UserId Gibt die ID als Benutzerprinzipalnamen (USER Principal Name, UPN) oder UserId an.
• -UserType Klassifizieren von Benutzertypen in Ihrem Verzeichnis, z. B. "Mitglied" und "Gast".
• -PasswordPolicies Gibt Kennwortrichtlinien für den Benutzer an.
• -OtherMails Gibt weitere E-Mail-Adressen für den Benutzer an.

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraUser -UserId 'SawyerM@contoso.com' -PasswordProfile @{
    Password = '*****'
    ForceChangePasswordNextSignIn = $true
}

In diesem Beispiel wird der Parameter "PasswordProfile" des angegebenen Benutzers aktualisiert.

• -UserId Gibt die ID als Benutzerprinzipalnamen (USER Principal Name, UPN) oder UserId an.
• -PasswordProfile gibt das Kennwortprofil des Benutzers an.

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraUser -UserId 'SawyerM@contoso.com' -UsageLocation 'US'

In diesem Beispiel wird der Verwendungsspeicherort des angegebenen Benutzers für die Lizenzverwaltung aktualisiert.

• -UserId Gibt die ID als Benutzerprinzipalnamen (USER Principal Name, UPN) oder UserId an.
• -UsageLocation Gibt den Verwendungsort des Benutzers an. Iso 3166-Ländercode mit zwei Buchstaben. Erforderlich, damit lizenzierte Benutzer die Dienstverfügbarkeit überprüfen können. Beispiele: US, JP, GB. Nicht nullfähig.

Connect-Entra -Scopes 'User.ReadWrite.All'
Get-EntraUser -UserId 'SawyerM@contoso.com' | Set-EntraUser -PasswordPolicies DisablePasswordExpiration

In diesem Beispiel wird die Kennwortrichtlinie des angegebenen Benutzers aktualisiert.

Mögliche Werte für Kennwortrichtlinien sind:

• DisableStrongPassword: Ermöglicht schwächere Kennwörter als die Standardrichtlinie.
• DisablePasswordExpiration: Verhindert, dass Kennwörter ablaufen.

Sie können beide Werte zusammen angeben, z. B.: DisablePasswordExpiration und DisableStrongPassword. Beispiel: Set-EntraUser -UserId 'SawyerM@contoso.com' -PasswordPolicies "DisablePasswordExpiration,DisableStrongPassword"

Connect-Entra -Scopes 'User.ReadWrite.All'
$application = Get-EntraApplication -Filter "DisplayName eq 'Helpdesk Application'"
$extensionName = (Get-EntraApplicationExtensionProperty -ApplicationId $application.Id).Name | Select-Object -First 1
$additionalProperties = @{ $extensionName = "Survey.Report" }
Set-EntraUser -UserId 'SawyerM@contoso.com' -AdditionalProperties $additionalProperties

In diesem Beispiel werden die Erweiterungseigenschaften des angegebenen Benutzers aktualisiert, z. B. eine App-Rolle für eine Anwendung.

• -UserId Gibt die ID als Benutzerprinzipalnamen (USER Principal Name, UPN) oder UserId an.

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraUser -UserId 'SawyerM@contoso.com' -AdditionalProperties @{
    onPremisesExtensionAttributes = @{
        extensionAttribute1 = "Job Group D"
        extensionAttribute2 = "Audit Role"
    }
}

In diesem Beispiel werden die onPremisesExtensionAttributes-Eigenschaften des angegebenen Benutzers aktualisiert.

• -UserId Gibt die ID als Benutzerprinzipalnamen (USER Principal Name, UPN) oder UserId an.

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraUser -UserId 'SawyerM@contoso.com' -BusinessPhones '+1 425 555 0109' -OfficeLocation '18/2111'

In diesem Beispiel werden die onPremisesExtensionAttributes-Eigenschaften des angegebenen Benutzers aktualisiert.

• -UserId Gibt die ID als Benutzerprinzipalnamen (USER Principal Name, UPN) oder UserId an.

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.

Update-EntraUser ist ein Alias für Set-EntraUser.