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.Displayname
Beispiel 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' }
Mit diesem Befehl wird die Eigenschaft des angegebenen Benutzers aktualisiert.
Parameter
-AccountEnabled
Gibt an, ob das Konto aktiviert ist.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AgeGroup
Wird von Unternehmensanwendungen verwendet, um die gesetzliche Altersgruppe des Benutzers zu bestimmen. Diese Eigenschaft ist schreibgeschützt und wird basierend auf den Eigenschaften ageGroup und consentProvidedForMinor berechnet. Zulässige Werte: null
, minor
und adult
notAdult
. Weitere Informationen finden Sie unter [Eigenschaftendefinitionen der gesetzlichen Altersgruppe][Weitere Informationen zu Altersklassen- und Nebengenehmigungsdefinitionen].
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-City
Gibt die Stadt des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CompanyName
Der Unternehmensname, dem der Benutzer zugeordnet ist. Diese Eigenschaft kann nützlich sein, um das Unternehmen zu beschreiben, von dem ein externer Benutzer stammt. Die maximale Länge des Firmennamens beträgt 64 Zeichen.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConsentProvidedForMinor
Legt fest, ob die Zustimmung für Minderjährige eingeholt wurde. Zulässige Werte: null
, granted
und notRequired
denied
. Weitere Informationen finden Sie unter [Eigenschaftendefinitionen der gesetzlichen Altersgruppe][Weitere Informationen zu Definitionen für Altersgruppen und geringfügige Zustimmungen].
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Country
Gibt das Land oder die Region des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Department
Gibt die Abteilung des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Gibt den Anzeigenamen des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtensionProperty
Fügen Sie daten zu benutzerdefinierten Benutzereigenschaften als grundlegende offene Erweiterungen oder die vielseitigeren Schemaerweiterungen hinzu. Weitere Informationen finden Sie unter [weitere Informationen zu Erweiterungen][Weitere Informationen zu Erweiterungen].
Type: | Dictionary<TKey,TValue>[System.String,System.String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FacsimileTelephoneNumber
Die Faxnummer des Benutzers.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GivenName
Gibt den angegebenen Namen des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsCompromised
True, wenn dieser Benutzer kompromittiert ist
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobTitle
Gibt die Auftragsbezeichnung des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MailNickName
Gibt einen Spitznamen für die E-Mail-Adresse des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Mobile
Gibt die Mobiltelefonnummer des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectId
Gibt die ID eines Benutzers (als UPN oder ObjectId) in Azure AD an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OtherMails
Gibt andere E-Mail-Adressen für den Benutzer an.
Type: | List<T>[String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordPolicies
Gibt Kennwortrichtlinien für den Benutzer an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordProfile
Gibt das Kennwortprofil des Benutzers an.
Type: | PasswordProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhysicalDeliveryOfficeName
Position des Büros am Unternehmensstandort des Benutzers. Die maximale Länge beträgt 128 Zeichen.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PostalCode
Gibt die Postleitzahl des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreferredLanguage
Gibt die bevorzugte Sprache des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShowInAddressList
Legen Sie auf True fest, um diesen Benutzer in der Adressliste anzuzeigen.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SignInNames
Die Liste der Anmeldenamen für diesen Benutzer
Type: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
Gibt den Status des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StreetAddress
Gibt die Straßenadresse des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Surname
Gibt den Nachnamen des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TelephoneNumber
Gibt die Telefonnummer des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UsageLocation
Ein Länder- oder Regionscode aus zwei Buchstaben (ISO-Norm 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPrincipalName
Gibt den Benutzerprinzipalnamen des Benutzers an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserState
Für einen externen Benutzer, der über die Einladungs-API zum Mandanten eingeladen wird, stellt diese Eigenschaft die Einladung des eingeladenen Benutzers status dar. Für eingeladene Benutzer kann der Status oder Accepted
oder null
für alle anderen Benutzer seinPendingAcceptance
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserStateChangedOn
Zeigt den Zeitstempel für die letzte Änderung der externalUserState-Eigenschaft an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserType
Ein Zeichenfolgenwert, der zum Klassifizieren von Benutzertypen in Ihrem Verzeichnis verwendet werden kann, z.B. als „Mitglied“ oder als „Gast“.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Hinweise
Weitere Informationen finden Sie im Migrationsleitfaden für Set-AzureADUser zu Microsoft Graph PowerShell.
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für