New-MsolUser
Erstellt einen Benutzer in Azure Active Directory.
Syntax
New-MsolUser
[-ImmutableId <String>]
[-UserPrincipalName <String>]
[-BlockCredential <Boolean>]
[-City <String>]
[-Country <String>]
[-Department <String>]
[-DisplayName <String>]
[-Fax <String>]
[-FirstName <String>]
[-LastName <String>]
[-LastPasswordChangeTimestamp <DateTime>]
[-MobilePhone <String>]
[-Office <String>]
[-PasswordNeverExpires <Boolean>]
[-PhoneNumber <String>]
[-PostalCode <String>]
[-PreferredDataLocation <String>]
[-PreferredLanguage <String>]
[-SoftDeletionTimestamp <DateTime>]
[-State <String>]
[-StreetAddress <String>]
[-StrongPasswordRequired <Boolean>]
[-Title <String>]
[-UsageLocation <String>]
[-AlternateEmailAddresses <String[]>]
[-StrongAuthenticationMethods <StrongAuthenticationMethod[]>]
[-AlternateMobilePhones <String[]>]
[-StrongAuthenticationRequirements <StrongAuthenticationRequirement[]>]
[-StsRefreshTokensValidFrom <DateTime>]
[-UserType <UserType>]
[-Password <String>]
[-LicenseOptions <LicenseOption[]>]
[-ForceChangePassword <Boolean>]
[-LicenseAssignment <String[]>]
[-TenantId <Guid>]
[<CommonParameters>] Beschreibung
Das Cmdlet New-MsolUser erstellt einen Benutzer in Azure Active Directory. Um dem Benutzer Zugriff auf Dienste zu gewähren, weisen Sie eine Lizenz mit dem Parameter LicenseAssignment zu .
Beispiele
Beispiel 1: Erstellen eines Benutzers
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew"Mit diesem Befehl wird ein Benutzer erstellt. Dem Benutzer sind keine Lizenzen zugewiesen. Für den Benutzer wird ein zufälliges Kennwort generiert.
Beispiel 2: Erstellen eines Benutzers und Zuweisen einer Lizenz
Hinweis
Der Parameter -LicenseAssignment ist veraltet. Erfahren Sie , wie Sie Lizenzen mit Microsoft Graph PowerShell zuweisen. Weitere Informationen finden Sie in der Microsoft Graph-API zum Zuweisen von Lizenzen .
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.com" -DisplayName "David Chew" -FirstName "David" -LastName "Chew" -UsageLocation "US" -LicenseAssignment "Contoso:BPOS_Standard"Dieser Befehl erstellt einen neuen Benutzer und weist eine Lizenz zu.
Beispiel 3: Erstellen eines Benutzers und eines bevorzugten Datenspeicherorts
PS C:\> New-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" -DisplayName "David" -PreferredDataLocation "EUR"Mit diesem Befehl wird ein Benutzer erstellt, dessen Benutzerprinzipalname ist jdavidchew@contoso.onmicrosoft.com, der Anzeigename David und der bevorzugte Datenspeicherort EUR ist.
Parameter
-AlternateEmailAddresses
Gibt alternative E-Mail-Adressen für den Benutzer an.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-AlternateMobilePhones
Gibt alternative Mobiltelefonnummern für den Benutzer an.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-BlockCredential
Gibt an, ob sich der Benutzer nicht mit seiner Benutzer-ID anmelden kann.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | $false |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-City
Gibt die Stadt des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Country
Gibt das Land oder die Region des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Department
Gibt die Abteilung des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-DisplayName
Gibt den Anzeigenamen des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Fax
Gibt die Faxnummer des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-FirstName
Gibt den Vornamen des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ForceChangePassword
Gibt an, dass der Benutzer sein Kennwort bei der nächsten Anmeldung ändern muss.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | $true |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ImmutableId
Gibt die unveränderliche ID der Verbundidentität des Benutzers an. Dies sollte für Benutzer mit Standardidentitäten weggelassen werden.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-LastName
Gibt den Nachnamen des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-LastPasswordChangeTimestamp
Gibt einen Zeitpunkt an, zu dem das Kennwort zuletzt geändert wurde.
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-LicenseAssignment
Gibt ein Array von Lizenzen an, die dem Benutzer zugewiesen werden sollen.
Hinweis
Der Parameter -LicenseAssignment ist veraltet. Erfahren Sie , wie Sie Lizenzen mit Microsoft Graph PowerShell zuweisen. Weitere Informationen finden Sie in der Microsoft Graph-API zum Zuweisen von Lizenzen .
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-LicenseOptions
Gibt die Optionen für die Lizenzzuweisung an. Wird verwendet, um einzelne Servicepläne innerhalb einer SKU selektiv zu deaktivieren.
| Typ: | LicenseOption[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-MobilePhone
Gibt die Mobiltelefonnummer des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Office
Gibt das Büro des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Password
Gibt das neue Kennwort für den Benutzer an. Ist für den Benutzer festgelegt, dass ein sicheres Kennwort erforderlich ist, müssen alle folgenden Regeln erfüllt sein:
- Das Kennwort muss mindestens einen Kleinbuchstaben enthalten.
- Das Kennwort muss mindestens einen Großbuchstaben enthalten.
- Das Kennwort muss mindestens ein nicht alphanumerisches Zeichen enthalten.
- Das Kennwort darf keine Leerzeichen, Registerkarten oder Zeilenumbrüche enthalten.
- Die Länge des Kennworts muss 8 bis 16 Zeichen lang sein.
- Der Benutzername kann nicht im Kennwort enthalten sein.
Wenn dieser Wert weggelassen wird, wird dem Benutzer ein zufälliges Kennwort zugewiesen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-PasswordNeverExpires
Gibt an, ob das Benutzerkennwort in regelmäßigen Abständen abläuft.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | $false |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-PhoneNumber
Gibt die Telefonnummer des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-PostalCode
Gibt die Postleitzahl des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-PreferredDataLocation
Gibt den bevorzugten Speicherort für den Benutzer an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-PreferredLanguage
Gibt die bevorzugte Sprache des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-SoftDeletionTimestamp
Gibt einen Zeitpunkt für das vorläufige Löschen an.
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-State
Gibt den Bundesstaat oder die Provinz an, in dem sich der Benutzer befindet.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StreetAddress
Gibt die Adresse des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StrongAuthenticationMethods
Gibt ein Array starker Authentifizierungsmethoden an.
| Typ: | StrongAuthenticationMethod[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StrongAuthenticationRequirements
Gibt ein Array mit starken Authentifizierungsanforderungen an.
| Typ: | StrongAuthenticationRequirement[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StrongPasswordRequired
Gibt an, ob ein sicheres Kennwort für den Benutzer erforderlich ist.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | $true |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StsRefreshTokensValidFrom
Gibt einen StsRefreshTokensValidFrom-Wert an.
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-TenantId
Gibt die eindeutige ID des Mandanten an, auf dem der Vorgang ausgeführt werden soll. Der Standardwert ist der Mandant des aktuellen Benutzers. Dieser Parameter gilt nur für Partnerbenutzer.
| Typ: | Guid |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Title
Gibt den Titel des Benutzers an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-UsageLocation
Gibt den Speicherort des Benutzers an, an dem Dienste genutzt werden. Geben Sie einen zweistelligen Länder- oder Regionscode an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-UserPrincipalName
Gibt die Benutzer-ID für diesen Benutzer an. Dies ist erforderlich.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-UserType
Gibt den Benutzertyp an.
| Typ: | UserType |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
Ausgaben
Microsoft.Online.Administration.User
Dieses Cmdlet gibt Details zum neuen Benutzer zurück, der erstellt wurde, einschließlich seines temporären Kennworts.