New-AzureADUser
Erstellt einen Azure AD-Benutzer.
Syntax
New-AzureADUser
[-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 New-AzureADUser erstellt einen Benutzer in Azure Active Directory (Azure AD).
Beispiele
Beispiel 1: Erstellen eines Benutzers
$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$PasswordProfile.Password = "<Password>"
New-AzureADUser -DisplayName "New User" -PasswordProfile $PasswordProfile -UserPrincipalName "NewUser@contoso.com" -AccountEnabled $true -MailNickName "Newuser"
ObjectId DisplayName UserPrincipalName UserType
-------- ----------- ----------------- --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user NewUser@contoso.com MemberMit diesem Befehl wird ein neuer Benutzer erstellt.
Parameter
-AccountEnabled
Gibt an, ob das Konto des Benutzers aktiviert ist.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AgeGroup
Dies gibt die Altersgruppe des Benutzers an.
| 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
Dadurch wird der Firmenname des Benutzers angegeben.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConsentProvidedForMinor
| 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.
Beim Erstellen eines lokalen Kontos ist die -Eigenschaft erforderlich, und Sie müssen sie auf LocalAccountfestlegen.
Geben Sie beim Erstellen eines Geschäfts-, Schul- oder Unikontos die -Eigenschaft nicht an, oder legen Sie sie auf fest null.
| 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: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExtensionProperty
| Type: | Dictionary<TKey,TValue>[System.String,System.String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FacsimileTelephoneNumber
Dadurch wird die Telefonnummer des Benutzers angegeben.
| 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 userPrincipalName (UPN) des Benutzers 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
Gibt an, ob 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 den E-Mail-Spitznamen 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 |
-OtherMails
Eine Liste zusätzlicher E-Mail-Adressen für den Benutzer. Platzhalter in einer derartigen Schreibweise sind z.B. bob@contoso.com und Robert@fabrikam.com.
| 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.
Dieser Wert ist eine Enumeration mit einem möglichen Wert DisableStrongPassword, wodurch schwächere Kennwörter als die Standardrichtlinie angegeben werden können.
DisablePasswordExpiration kann auch angegeben werden.
Die beiden Werte können zusammen angegeben werden. Beispiel: „DisablePasswordExpiration, DisableStrongPassword“.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PasswordProfile
Gibt das Kennwortprofil des Benutzers an.
Beachten Sie, dass der Parametertyp für diesen Parameter ist PasswordProfile.
Um einen Parameter dieses Typs zu übergeben, müssen Sie zuerst folgendes geben:
- Erstellen Sie eine Variable in PowerShell mit diesem Typ:
$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
- Legen Sie den Wert des Kennworts in dieser Variablen fest:
$PasswordProfile.Password = "\<Password\>"
- Übergeben Sie schließlich diese Variable an das Cmdlet:
New-AzureADUser -PasswordProfile $PasswordProfile ...
Weitere Attribute, die im PasswordProfile festgelegt werden können, sind:
$PasswordProfile.EnforceChangePasswordPolicy– ein boolescher Wert, der angibt, dass die Kennwortänderungsrichtlinie für diesen Benutzer aktiviert oder deaktiviert ist.$PasswordProfile.ForceChangePasswordNextLogin– ein boolescher Wert, der angibt, dass der Benutzer das Kennwort bei der nächsten Anmeldung ändern muss.
| Type: | PasswordProfile |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PhysicalDeliveryOfficeName
Gibt den Namen des physischen Übermittlungsbüros des Benutzers an.
| 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
Wenn True, zeigen Sie diesen Benutzer in der Adressliste an.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SignInNames
Gibt die Sammlung von Anmeldenamen für ein lokales Konto in einem Azure Active Directory B2C-Mandanten an
Jeder Anmeldename muss unter den Unternehmen/Mandanten eindeutig sein. Die -Eigenschaft muss angegeben werden, wenn Sie einen lokalen Kontobenutzer erstellen. Geben Sie es nicht an, wenn Sie ein Geschäfts-, Schul- oder Unikonto erstellen.
| 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 eine Telefonnummer 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).
Benutzer, denen aufgrund gesetzlicher Anforderungen Lizenzen zugewiesen werden, müssen die Verfügbarkeit von Diensten in Ländern und Regionen überprüfen.
Beispiele sind: US, JPund GB.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserPrincipalName
Gibt den Prinzipalnamen (UPN) des Benutzers an.
Der UPN ist ein Anmeldename im Internetformat für den Benutzer basierend auf dem Internetstandard RFC 822.
Gemäß der Konvention sollte er dem E-Mail-Namen des Benutzers entsprechen.
Das allgemeine Format ist alias@domain.
Bei Geschäfts-, Schul- oder Unikonten muss die Domäne in der Sammlung der überprüften Domänen des Mandanten enthalten sein. Beim Erstellen eines Geschäfts-, Schul- oder Unikontos ist diese Eigenschaft erforderlich. Für lokale Konten ist sie optional.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserState
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserStateChangedOn
| 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 New-AzureADUser zu Microsoft Graph PowerShell.
Ähnliche Themen
Feedback
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 unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für