New-AzADUser

Syntax

WithPassword (Standard)

New-AzADUser
    -DisplayName <String>
    -MailNickname <String>
    -UserPrincipalName <String>
    -Password <SecureString>
    [-AboutMe <String>]
    [-AccountEnabled <Boolean>]
    [-AgeGroup <String>]
    [-Birthday <DateTime>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DeviceEnrollmentLimit <Int32>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-HireDate <DateTime>]
    [-Interest <String[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MobilePhone <String>]
    [-MySite <String>]
    [-OfficeLocation <String>]
    [-ImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-PreferredName <String>]
    [-Responsibility <String[]>]
    [-School <String[]>]
    [-ShowInAddressList]
    [-Skill <String[]>]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-ForceChangePasswordNextLogin]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

WithPasswordProfile

New-AzADUser
    -DisplayName <String>
    -MailNickname <String>
    -UserPrincipalName <String>
    -PasswordProfile <IMicrosoftGraphPasswordProfile>
    [-AboutMe <String>]
    [-AccountEnabled <Boolean>]
    [-AgeGroup <String>]
    [-Birthday <DateTime>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DeviceEnrollmentLimit <Int32>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-HireDate <DateTime>]
    [-Interest <String[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MobilePhone <String>]
    [-MySite <String>]
    [-OfficeLocation <String>]
    [-ImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-PreferredName <String>]
    [-Responsibility <String[]>]
    [-School <String[]>]
    [-ShowInAddressList]
    [-Skill <String[]>]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Beispiele

Beispiel 1: Erstellen eines Benutzers mit Kennwortprofil

$password = "xxxxxxxxxx"
$pp = New-Object -TypeName "Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordProfile" -Property @{Password=$password}
New-AzADUser -DisplayName $uname -PasswordProfile $pp -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upn

Beispiel 2: Erstellen eines Benutzers mit Kennwort

$password = ConvertTo-SecureString -String "****" -AsPlainText -Force
New-AzADUser -DisplayName $uname -Password $password -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upn

Parameter

-AboutMe

Ein Freihandform-Texteingabefeld, in dem der Benutzer sich selbst beschreiben kann. Wird nur für $select zurückgegeben.

Parametereigenschaften

Parametersätze

-AccountEnabled

true für die Aktivierung des Kontos; andernfalls "false".

Parametereigenschaften

Parametersätze

-AgeGroup

Legt die Altersgruppe des Benutzers fest. Zulässige Werte: null, minor, notAdult und adult. Weitere Informationen finden Sie in den Gesetzlichen Altersklassen-Eigenschaftsdefinitionen. Unterstützt $filter (eq, ne, NOT und in).

Parametereigenschaften

Parametersätze

-Birthday

Der Geburtstag des Benutzers. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC-Zeit am 1. Januar 2014 ist z. B. 2014-01-01T00:00:00Z nur für $select zurückgegeben.

Parametereigenschaften

Parametersätze

-City

Die Stadt, in der sich der Benutzer befindet. Die maximale Länge beträgt 128 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-CompanyName

Der Firmenname, dem der Benutzer zugeordnet ist. Diese Eigenschaft kann nützlich sein, um die Firma zu beschreiben, aus der ein externer Benutzer kommt. Die maximale Länge des Firmennamens beträgt 64 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Parametersätze

-ConsentProvidedForMinor

Legt fest, ob die Einverständniserklärung für Minderjährige eingeholt wurde. Zulässige Werte: NULL, gewährt, verweigert und nicht angefordert. Weitere Informationen finden Sie in den Gesetzlichen Altersklassen-Eigenschaftsdefinitionen. Unterstützt $filter (eq, ne, NOT und in).

Parametereigenschaften

Parametersätze

-Country

Das Land/die Region, in dem sich der Benutzer befindet; z. B. USA oder Uk. Die maximale Länge beträgt 128 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Parametereigenschaften

Parametersätze

-DeletedDateTime

.

Parametereigenschaften

Parametersätze

-Department

Der Name der Abteilung, in der der Benutzer arbeitet. Die maximale Länge beträgt 64 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le und in Operatoren).

Parametereigenschaften

Parametersätze

-DeviceEnrollmentLimit

Der Grenzwert für die maximale Anzahl von Geräten, die der Benutzer registrieren kann. Zulässige Werte sind 5 oder 1000.

Parametereigenschaften

Parametersätze

-DisplayName

Der Name des Benutzers, der im Adressbuch angezeigt wird. Dieser Wert besteht normalerweise aus einer Kombination aus dem Vornamen, der Initiale des weiteren Vornamens und des Nachnamens. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird und während updates nicht gelöscht werden kann. Die maximale Länge beträgt 256 Zeichen. Unterstützt $filter (eq, ne, NOT , ge, le, in, startsWith), $orderBy und $search.

Parametereigenschaften

Parametersätze

-EmployeeHireDate

Das Datum und die Uhrzeit, zu dem der Benutzer eingestellt wurde, oder beginnt bei einer zukünftigen Einstellung mit der Arbeit. Unterstützt $filter (eq, ne, NOT , ge, le, in).

Parametereigenschaften

Parametersätze

-EmployeeId

Die Mitarbeiter-ID, die dem Benutzer von der Organisation zugewiesen wurde. Unterstützt $filter (eq, ne, NOT , ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-EmployeeType

Erfasst den Arbeitnehmertyp des Unternehmens. Beispiel: Mitarbeiter, Auftragnehmer, Berater oder Lieferant. Unterstützt $filter (eq, ne, NOT , ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-ExternalUserState

Für einen externen Benutzer, der mit der Einladungs-API zum Mandanten eingeladen wurde, stellt diese Eigenschaft den Einladungsstatus des eingeladenen Benutzers dar. Für eingeladene Benutzer kann der Status "PendingAcceptance" oder "Accepted" oder "Null" für alle anderen Benutzer sein. Unterstützt $filter (eq, ne, NOT , in).

Parametereigenschaften

Parametersätze

-ExternalUserStateChangeDateTime

Zeigt den Zeitstempel für die letzte Änderung an der externalUserState-Eigenschaft an. Unterstützt $filter (eq, ne, NOT , in).

Parametereigenschaften

Parametersätze

-FaxNumber

Die Faxnummer des Benutzers. Unterstützt $filter (eq, ne, NOT , ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-ForceChangePasswordNextLogin

Es muss angegeben werden, wenn der Benutzer das Kennwort bei der nächsten erfolgreichen Anmeldung (true) ändern muss. Das Standardverhalten ist (false), um das Kennwort bei der nächsten erfolgreichen Anmeldung nicht zu ändern.

Parametereigenschaften

Parametersätze

-GivenName

Der Vorname des Benutzers. Die maximale Länge beträgt 64 Zeichen. Unterstützt $filter (eq, ne, NOT , ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-HireDate

Das Einstellungsdatum des Benutzers. Der Timestamp-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC am 1. Januar 2014 lautet beispielsweise 2014-01-01T00:00:00Z. Wird nur für $select zurückgegeben. Hinweis: Diese Eigenschaft ist spezifisch für SharePoint Online. Es wird empfohlen, die native EmployeeHireDate-Eigenschaft zum Festlegen und Aktualisieren von Einstellungsdatumswerten mithilfe von Microsoft Graph-APIs zu verwenden.

Parametereigenschaften

Parametersätze

-ImmutableId

Diese Eigenschaft wird verwendet, um ihrem Azure AD-Benutzerobjekt ein lokales Active Directory-Benutzerkonto zuzuordnen. Diese Eigenschaft muss beim Erstellen eines neuen Benutzerkontos in Graph angegeben werden, wenn Sie eine Verbunddomäne für die UserPrincipalName (UPN)-Eigenschaft des Benutzers verwenden. HINWEIS: Die Zeichen $ und _ können nicht verwendet werden, wenn Sie diese Eigenschaft angeben. Wird nur für $select zurückgegeben. Unterstützt $filter (eq, ne, NOT, ge, le, in)..

Parametereigenschaften

Parametersätze

-Interest

Eine Liste für den Benutzer, um dessen Interessen zu beschreiben. Wird nur für $select zurückgegeben.

Parametereigenschaften

Parametersätze

-IsResourceAccount

Nicht verwenden – reserviert für die zukünftige Verwendung.

Parametereigenschaften

Parametersätze

-JobTitle

Die Position des Benutzers. Die maximale Länge beträgt 128 Zeichen. Unterstützt $filter (eq, ne, NOT , ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-Mail

SMTP-Adresse für den Benutzer, z. B. admin@contoso.com. Änderungen an dieser Eigenschaft aktualisieren auch die ProxyAddresses-Auflistung des Benutzers, um den Wert als SMTP-Adresse einzuschließen. Obwohl diese Eigenschaft Akzentzeichen enthalten kann, kann die Verwendung zu Zugriffsproblemen mit anderen Microsoft-Anwendungen für den Benutzer führen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

Parametereigenschaften

Parametersätze

-MailNickname

Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss beim Erstellen eines Benutzers angegeben werden. Die maximale Länge beträgt 64 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-MobilePhone

Die Nummer des primären Mobiltelefons für den Benutzer. Schreibgeschützt für Benutzer, die aus dem lokalen Verzeichnis synchronisiert wurden. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-MySite

Die URL für die persönliche Website des Benutzers. Wird nur für $select zurückgegeben.

Parametereigenschaften

Parametersätze

-OfficeLocation

Der Bürostandort der Firma des Benutzers Die maximale Länge beträgt 128 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-OtherMail

Eine Liste zusätzlicher E-Mail-Adressen für den Benutzer; Beispiel: ['bob@contoso.com,', 'Robert@fabrikam.com']. HINWEIS: Obwohl diese Eigenschaft Akzentzeichen enthalten kann, können sie Zugriffsprobleme auf Erstanbieteranwendungen für den Benutzer verursachen. Unterstützt $filter (eq, NOT, ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-Password

Kennwort für den Benutzer Sie muss die Anforderungen an die Kennwortkomplexität des Mandanten erfüllen. Es wird empfohlen, ein sicheres Kennwort festzulegen.

Parametereigenschaften

Parametersätze

-PasswordPolicy

Gibt die Kennwortrichtlinien für den Benutzer an. Dieser Wert ist eine Aufzählung mit einem möglichen Wert, der DisableStrongPassword ist, wodurch schwächere Kennwörter als die Standardrichtlinie angegeben werden können. DisablePasswordExpiration kann auch angegeben werden. Die beiden können zusammen angegeben werden; Beispiel: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

Parametereigenschaften

Parametersätze

-PasswordProfile

passwordProfile To construct, see NOTES section for PASSWORDPROFILE properties and create a hash table.

Parametereigenschaften

Parametersätze

-PostalCode

Die Postleitzahl für die Postanschrift des Benutzers. Die Postleitzahl ist für das Land/die Region des Benutzers spezifisch. In den USA enthält dieses Attribut den ZIP Code. Die maximale Länge beträgt 40 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-PreferredLanguage

Die bevorzugte Sprache für den Benutzer. Sollte dem ISO 639-1-Code folgen; z. B. en-US. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-PreferredName

Der bevorzugte Name für den Benutzer. Wird nur für $select zurückgegeben.

Parametereigenschaften

Parametersätze

-Responsibility

Eine Liste zur Aufzählung der Verantwortlichkeiten eines Benutzers. Wird nur für $select zurückgegeben.

Parametereigenschaften

Parametersätze

-School

Eine Liste zur Aufzählung der vom Benutzer besuchten Schulen. Wird nur für $select zurückgegeben.

Parametereigenschaften

Parametersätze

-ShowInAddressList

"true", wenn die globale Adressliste von Outlook diesen Benutzer enthalten soll, andernfalls "false". Wenn sie nicht festgelegt ist, wird dies als "true" behandelt. Für Benutzer, die über den Einladungs-Manager eingeladen wurden, wird diese Eigenschaft auf "false" festgelegt. Unterstützt $filter (eq, ne, NOT, in).

Parametereigenschaften

Parametersätze

-Skill

Eine Liste zur Aufzählung der Qualifikationen eines Benutzers. Wird nur für $select zurückgegeben.

Parametereigenschaften

Parametersätze

-State

Bundesland oder Kanton in der Adresse des Benutzers. Die maximale Länge beträgt 128 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-StreetAddress

Die Straße der Firma des Benutzers. Die maximale Länge beträgt 1024 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-Surname

Der Nachname des Benutzers. Die maximale Länge beträgt 64 Zeichen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-UsageLocation

Ein aus zwei Buchstaben bestehender Ländercode (ISO-Standard 3166). Erforderlich für Benutzer, denen Lizenzen zugewiesen werden, aufgrund der gesetzlichen Anforderung, die Verfügbarkeit von Diensten in Ländern zu überprüfen. Beispiele: US, JP und GB. Lässt keine NULL-Werte zu. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith).

Parametereigenschaften

Parametersätze

-UserPrincipalName

Der Benutzerprinzipalname (UPN) des Benutzers. Der UPN ist ein Anmeldename im Internetstil für den Benutzer basierend auf dem Internetstandard RFC 822. Gemäß der Konvention sollte er dem E-Mail-Namen des Benutzers zugeordnet sein. Das allgemeine Format lautet „alias@domäne“, wobei „domäne“ in der Sammlung der verifizierten Domänen des Mandanten vorhanden sein muss. Diese Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird. Auf die überprüften Domänen für den Mandanten kann über die verifiedDomains-Eigenschaft der Organisation zugegriffen werden. HINWEIS: Obwohl diese Eigenschaft Akzentzeichen enthalten kann, können sie Zugriffsprobleme auf Erstanbieteranwendungen für den Benutzer verursachen. Unterstützt $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) und $orderBy.

Parametereigenschaften

Parametersätze

-UserType

Ein Zeichenfolgenwert, der zum Klassifizieren von Benutzertypen in Ihrem Verzeichnis verwendet werden kann, z. B. "Mitglied" und "Gast". Unterstützt $filter (eq, ne, NOT, in,).

Parametereigenschaften

Parametersätze

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Parametersätze

CommonParameters

Ausgaben

IMicrosoftGraphUser