Set-AzureADUser
Aktualisiert einen Benutzer.
Syntax
Set-AzureADUser
-ObjectId <String>
[-ExtensionProperty <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
[-AccountEnabled <Boolean>]
[-AgeGroup <String>]
[-City <String>]
[-CompanyName <String>]
[-ConsentProvidedForMinor <String>]
[-Country <String>]
[-CreationType <String>]
[-Department <String>]
[-DisplayName <String>]
[-FacsimileTelephoneNumber <String>]
[-GivenName <String>]
[-IsCompromised <Boolean>]
[-ImmutableId <String>]
[-JobTitle <String>]
[-MailNickName <String>]
[-Mobile <String>]
[-OtherMails <System.Collections.Generic.List`1[System.String]>]
[-PasswordPolicies <String>]
[-PasswordProfile <PasswordProfile>]
[-PhysicalDeliveryOfficeName <String>]
[-PostalCode <String>]
[-PreferredLanguage <String>]
[-ShowInAddressList <Boolean>]
[-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
[-State <String>]
[-StreetAddress <String>]
[-Surname <String>]
[-TelephoneNumber <String>]
[-UsageLocation <String>]
[-UserPrincipalName <String>]
[-UserState <String>]
[-UserStateChangedOn <String>]
[-UserType <String>]
[<CommonParameters>] Beschreibung
Das Cmdlet Set-AzureADUser aktualisiert einen Benutzer in Azure Active Directory (AD).
Beispiele
Beispiel 1: Aktualisieren eines Benutzers
PS C:\> $user = Get-AzureADUser -ObjectId TestUser@example.com
PS C:\> $user.DisplayName = 'YetAnotherTestUser'
PS C:\> Set-AzureADUser -ObjectId TestUser@example.com -Displayname $user.DisplaynameBeispiel 2: Festlegen aller außer angegebenen Benutzer als Minderjährige mit elterlicher Zustimmung
Get-AzureADUser -All $true |
Where-Object -FilterScript { $_.DisplayName -notmatch '(George|James|Education)' } |
ForEach-Object { Set-AzureADUser -ObjectId $($_.ObjectId) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }Dieser Befehl aktualisiert die Eigenschaft des angegebenen Benutzers.
Parameter
-AccountEnabled
Gibt an, ob das Konto aktiviert ist.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AgeGroup
Wird von Unternehmensanwendungen verwendet, um die Altersgruppe des Benutzers zu bestimmen. Diese Eigenschaft ist schreibgeschützt und wird basierend auf den Eigenschaften ageGroup und consentProvidedForMinor berechnet. Zulässige Werte: null, minorund adultnotAdult . Weitere Informationen finden Sie unter [Eigenschaftendefinitionen der gesetzlichen Altersklasse][Weitere Informationen zu Definitionen für Altersgruppen und geringfügige Zustimmungen].
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-City
Gibt die Stadt des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CompanyName
Der Firmenname, dem der Benutzer zugeordnet ist. Diese Eigenschaft kann nützlich sein, um das Unternehmen zu beschreiben, aus dem ein externer Benutzer stammt. Die maximale Länge des Firmennamens beträgt 64 Zeichen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ConsentProvidedForMinor
Legt fest, ob die Zustimmung für Minderjährige eingeholt wurde. Zulässige Werte: null, grantedund notRequireddenied . Weitere Informationen finden Sie unter [Eigenschaftendefinitionen der gesetzlichen Altersklasse][Weitere Informationen zu Altersklassen- und Geringfügigen Zustimmungsdefinitionen].
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Country
Gibt das Land oder die Region des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CreationType
Gibt an, ob das Benutzerkonto ein lokales Konto für einen Azure Active Directory B2C-Mandanten ist. Mögliche Werte sind „LocalAccount“ und null. Die Eigenschaft ist erforderlich, wenn Sie ein lokales Konto erstellen, und sie muss auf „LocalAccount“ festgelegt werden. Wenn Sie ein Geschäfts-, Schul- oder Unikonto erstellen, geben Sie diese Eigenschaft nicht an, oder legen Sie sie auf null fest.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Department
Gibt die Abteilung des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisplayName
Gibt den Anzeigenamen des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ExtensionProperty
Fügen Sie daten zu benutzerdefinierten Benutzereigenschaften als die grundlegenden offenen Erweiterungen oder die vielseitigeren Schemaerweiterungen hinzu. Weitere Informationen finden Sie unter [Weitere Informationen zu Erweiterungen][Weitere Informationen zu Erweiterungen].
| Typ: | Dictionary<TKey,TValue>[System.String,System.String] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-FacsimileTelephoneNumber
Die Faxnummer des Benutzers.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-GivenName
Gibt den angegebenen Namen des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ImmutableId
Diese Eigenschaft wird verwendet, um ein lokales Active Directory-Benutzerkonto dem entsprechenden Azure AD-Benutzerobjekt zuzuordnen. Diese Eigenschaft muss beim Erstellen eines neuen Benutzerkontos in Graph angegeben werden, wenn Sie eine Verbunddomäne für die Eigenschaft des userPrincipalName Benutzers (UPN) verwenden.
Wichtig: Die $ Zeichen und _ können nicht verwendet werden, wenn diese Eigenschaft angegeben wird.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-IsCompromised
True, wenn dieser Benutzer kompromittiert ist
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-JobTitle
Gibt die Position des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-MailNickName
Gibt einen Spitznamen für die E-Mail-Adresse des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Mobile
Gibt die Mobiltelefonnummer des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ObjectId
Gibt die ID eines Benutzers (als UPN oder ObjectId) in Azure AD an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-OtherMails
Gibt andere E-Mail-Adressen für den Benutzer an.
| Typ: | List<T>[String] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PasswordPolicies
Gibt Kennwortrichtlinien für den Benutzer an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PasswordProfile
Gibt das Kennwortprofil des Benutzers an.
| Typ: | PasswordProfile |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PhysicalDeliveryOfficeName
Position des Büros am Unternehmensstandort des Benutzers. Die maximale Länge beträgt 128 Zeichen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PostalCode
Gibt die Postleitzahl des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PreferredLanguage
Gibt die bevorzugte Sprache des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ShowInAddressList
Legen Sie auf True fest, um diesen Benutzer in der Adressliste anzuzeigen.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SignInNames
Die Liste der Anmeldenamen für diesen Benutzer
| Typ: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-State
Gibt den Status des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-StreetAddress
Gibt die Adresse des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Surname
Gibt den Nachnamen des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-TelephoneNumber
Gibt die Telefonnummer des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UsageLocation
Ein zweistelligen Länder- oder Regionscode (ISO-Standard 3166). Erforderlich für Benutzer, denen aufgrund gesetzlicher Anforderungen Lizenzen zugewiesen werden, um die Verfügbarkeit von Diensten in Ländern und Regionen zu überprüfen. Beispiele hierfür sind: „US“, „JP“ und „GB“. Lässt keine NULL-Werte zu.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UserPrincipalName
Gibt den Benutzerprinzipalnamen des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UserState
Für einen externen Benutzer, der über die Einladungs-API zum Mandanten eingeladen wird, stellt diese Eigenschaft den Einladungsstatus des eingeladenen Benutzers dar. Für eingeladene Benutzer kann der Status oder Acceptedoder null für alle anderen Benutzer seinPendingAcceptance.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UserStateChangedOn
Zeigt den Zeitstempel für die letzte Änderung an der externalUserState-Eigenschaft an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UserType
Ein Zeichenfolgenwert, der zum Klassifizieren von Benutzertypen in Ihrem Verzeichnis verwendet werden kann, z.B. als „Mitglied“ oder als „Gast“.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Hinweise
Weitere Informationen finden Sie im Migrationsleitfaden für Set-AzureADUser zu Microsoft Graph PowerShell.