New-EntraUser

Syntax

Default (Standard)

New-EntraUser

    -DisplayName <String>
    -AccountEnabled <Boolean>
    -PasswordProfile <PasswordProfile>
    [-City <String>]
    [-UserStateChangedOn <String>]
    [-CompanyName <String>]
    [-PreferredLanguage <String>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Mobile <String>]
    [-UsageLocation <String>]
    [-PostalCode <String>]
    [-AgeGroup <String>]
    [-CreationType <String>]
    [-ConsentProvidedForMinor <String>]
    [-MailNickName <String>]
    [-ImmutableId <String>]
    [-Country <String>]
    [-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
    [-Department <String>]
    [-PasswordPolicies <String>]
    [-JobTitle <String>]
    [-UserState <String>]
    [-UserType <String>]
    [-OtherMails <System.Collections.Generic.List`1[System.String]>]
    [-UserPrincipalName <String>]
    [-State <String>]
    [-StreetAddress <String>]
    [-BusinessPhones <String>]
    [-Surname <String>]
    [-ShowInAddressList <Boolean>]
    [<CommonParameters>]

Beschreibung

Beispiele

Beispiel 1: Erstellen eines Benutzers mit dem Parameter "MailNickName"

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$userParams = @{
    DisplayName       = 'Avery Iona'
    PasswordProfile   = $passwordProfile
    UserPrincipalName = 'AveryI@contoso.com'
    AccountEnabled    = $true
    MailNickName      = 'averyi'
}

New-EntraUser @userParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Avery Iona    AveryI@contoso.com             Member

Beispiel 2: Erstellen eines Benutzers mithilfe des AgeGroup-Parameters

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'

$userParams = @{
    DisplayName       = 'Peyton Davis'
    PasswordProfile   = $passwordProfile
    UserPrincipalName = 'PeytonD@contoso.com'
    AccountEnabled    = $true
    MailNickName      = 'PeytonD'
    AgeGroup          = 'adult'
}

New-EntraUser @userParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
bbbbbbbb-1111-2222-3333-cccccccccccc Peyton Davis    PeytonD@contoso.com             Member

Beispiel 3: Erstellen eines Benutzers mit dem Parameter "City"

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'

$userParams = @{
    DisplayName       = 'Blake Martin'
    PasswordProfile   = $passwordProfile
    UserPrincipalName = 'BlakeM@contoso.com'
    AccountEnabled    = $true
    MailNickName      = 'BlakeM'
    City              = 'New York'
}

New-EntraUser @userParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
cccccccc-2222-3333-4444-dddddddddddd Blake Martin    BlakeM@contoso.com             Member

Beispiel 4: Erstellen eines Benutzers mithilfe des Abteilungsparameters

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'
$userParams = @{
    DisplayName       = 'Parker Jones'
    PasswordProfile   = $passwordProfile
    UserPrincipalName = 'ParkerJ@contoso.com'
    AccountEnabled    = $true
    MailNickName      = 'ParkerJ'
    Department        = 'IT'
}

New-EntraUser @userParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
dddddddd-3333-4444-5555-eeeeeeeeeeee Parker Jones    ParkerJ@contoso.com             Member

Beispiel 5: Erstellen eines Benutzers mit dem Parameter "Mobile"

Connect-Entra -Scopes 'User.ReadWrite.All'
$passwordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$passwordProfile.Password = '<Password>'

$UserParams = @{
    DisplayName        = 'Sawyer Miller'
    PasswordProfile    = $passwordProfile
    UserPrincipalName  = 'SawyerM@contoso.com'
    AccountEnabled     = $true
    MailNickName       = 'SawyerM'
    Mobile             = '+18989898989'
}

New-EntraUser @UserParams

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
eeeeeeee-4444-5555-6666-ffffffffffff Sawyer Miller    SawyerM@contoso.com             Member

Parameter

-AccountEnabled

Gibt an, ob das Konto des Benutzers aktiviert ist.

Parametereigenschaften

Parametersätze

-AgeGroup

Gibt die Altersgruppe des Benutzers an.

Parametereigenschaften

Parametersätze

-BusinessPhones

Gibt eine Telefonnummer an.

Parametereigenschaften

Parametersätze

-City

Gibt die Stadt des Benutzers an.

Parametereigenschaften

Parametersätze

-CompanyName

Gibt den Firmennamen des Benutzers an.

Parametereigenschaften

Parametersätze

-ConsentProvidedForMinor

Legt fest, ob die Zustimmung für Minderjährige eingeholt wurde.

Parametereigenschaften

Parametersätze

-Country

Gibt das Land des Benutzers an.

Parametereigenschaften

Parametersätze

-CreationType

Gibt an, ob das Benutzerkonto ein lokales Konto für einen Microsoft Entra ID 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 "LocalAccount" festlegen.
• Wenn Benutzer ein Geschäfts-, Schul- oder Unikonto erstellen, geben Sie die Eigenschaft nicht an, oder legen Sie sie auf NULL fest.

Parametereigenschaften

Parametersätze

-Department

Gibt die Abteilung des Benutzers an.

Parametereigenschaften

Parametersätze

-DisplayName

Gibt den Anzeigenamen des Benutzers an.

Parametereigenschaften

Parametersätze

-FaxNumber

Gibt die Faxnummer des Benutzers an.

Parametereigenschaften

Parametersätze

-GivenName

Gibt den Vornamen des Benutzers an.

Parametereigenschaften

Parametersätze

-ImmutableId

Diese Eigenschaft verknüpft ein lokales Benutzerkonto mit seinem Microsoft Entra ID-Objekt und ist erforderlich, wenn ein neuer Benutzer in Microsoft Graph erstellt wird, wenn sich der BenutzerprincipalName (UPN) in einer Verbunddomäne befindet.

Wichtig: Die Zeichen $ und _ können beim Angeben dieser Eigenschaft nicht verwendet werden.

Parametereigenschaften

Parametersätze

-JobTitle

Gibt die Position des Benutzers an.

Parametereigenschaften

Parametersätze

-MailNickName

Gibt den E-Mail-Spitznamen des Benutzers an.

Parametereigenschaften

Parametersätze

-Mobile

Gibt die Mobiltelefonnummer des Benutzers an.

Parametereigenschaften

Parametersätze

-OtherMails

Eine Liste mit anderen E-Mail-Adressen für den Benutzer; beispiel: "bob@contoso.com", "Robert@fabrikam.com".

Parametereigenschaften

Parametersätze

-PasswordPolicies

Gibt die Kennwortrichtlinien für den Benutzer an. Dieser Wert ist eine Enumeration, deren einziger möglicher Wert „DisableStrongPassword“ lautet. Damit können schwächere Kennwörter als in der Standardrichtlinie angegeben festgelegt werden. Auch „DisablePasswordExpiration“ kann angegeben werden. Die beiden können zusammen angegeben werden; Beispiel: "DisablePasswordExpiration, DisableStrongPassword".

Parametereigenschaften

Parametersätze

-PasswordProfile

Gibt das Kennwortprofil des Benutzers an.

Der Parametertyp für diesen Parameter lautet "PasswordProfile".

Um einen Parameter dieses Typs zu übergeben, müssen Sie zunächst eine Variable in PowerShell mit diesem Typ erstellen:

$passwordProfile = New-Object -TypeName Microsoft. Open.AzureAD.Model.PasswordProfile

Anschließend können Sie den Wert des Kennworts in dieser Variablen festlegen:

$passwordProfile.Password = "<Password>"

Und schließlich können Sie diese Variable an das Cmdlet übergeben:

New-EntraUser -PasswordProfile $passwordProfile ...

Andere Attribute, die in PasswordProfile festgelegt werden können, sind

• $passwordProfile.EnforceChangePasswordPolicy – ein boolescher Wert, der angibt, dass die Änderungskennwortrichtlinie für diesen Benutzer $passwordProfile deaktiviert oder deaktiviert ist.

• ForceChangePasswordNextLogin – ein boolescher Wert, der angibt, dass der Benutzer das Kennwort bei der nächsten Anmeldung ändern muss.

Parametereigenschaften

Parametersätze

-PostalCode

Gibt die Postleitzahl des Benutzers an.

Parametereigenschaften

Parametersätze

-PreferredLanguage

Gibt die bevorzugte Sprache des Benutzers an.

Parametereigenschaften

Parametersätze

-ShowInAddressList

Wenn True, zeigen Sie diesen Benutzer in der Adressliste an.

Parametereigenschaften

Parametersätze

-SignInNames

Gibt die Auflistung von Anmeldenamen für ein lokales Konto in einem Microsoft Entra ID B2C-Mandanten an.

Jeder Anmeldename muss im gesamten Unternehmen/Mandanten eindeutig sein.

Die Eigenschaft muss angegeben werden, wenn Sie einen lokalen Kontobenutzer erstellen. geben Sie sie nicht an, wenn Sie ein Geschäfts-, Schul- oder Unikonto erstellen.

Parametereigenschaften

Parametersätze

-State

Gibt den Status des Benutzers an.

Parametereigenschaften

Parametersätze

-StreetAddress

Gibt die Straße des Benutzers an.

Parametereigenschaften

Parametersätze

-Surname

Gibt den Nachnamen des Benutzers an.

Parametereigenschaften

Parametersätze

-UsageLocation

Ein aus zwei Buchstaben bestehender Ländercode (ISO-Standard 3166).

Erforderlich für Benutzer, denen Lizenzen zugewiesen sind, aufgrund der gesetzlichen Anforderung, die Verfügbarkeit von Diensten in Ländern zu überprüfen.

Beispiele: "DE", "GB" und "US".

Parametereigenschaften

Parametersätze

-UserPrincipalName

Der Benutzerprinzipalname (User Principal Name, UPN) des Benutzers.

Der UPN ist ein Anmeldename im Internetformat für den Benutzer, der auf dem Internetstandard RFC 822 basiert.

In der Konvention sollte dieser UPN dem E-Mail-Namen des Benutzers zugeordnet werden.

Das allgemeine Format ist "alias@domain".

Für Geschäfts-, Schul- oder Unikonten muss die Domäne in der Sammlung der überprüften Domänen des Mandanten vorhanden sein.

Diese Eigenschaft ist erforderlich, wenn ein Geschäfts-, Schul- oder Unikonto erstellt wird. es ist optional für lokale Konten.

Parametereigenschaften

Parametersätze

-UserState

Für einen externen Benutzer, der mit der Einladungs-API zum Mandanten eingeladen wurde, stellt diese Eigenschaft den Einladungsstatus des eingeladenen Benutzers dar.

Parametereigenschaften

Parametersätze

-UserStateChangedOn

Zeigt den Zeitstempel für die neueste Änderung an der Eigenschaft "userState" an.

Parametereigenschaften

Parametersätze

-UserType

Ein Zeichenfolgenwert kann zum Klassifizieren der Benutzertypen in Ihrem Verzeichnis verwendet werden, z. B. "Member" und "Guest".

Parametereigenschaften

Parametersätze

CommonParameters

Ähnliche Themen

• Get-EntraUser
• Remove-EntraUser
• Set-EntraUser