New-EntraUser

Syntax

Default (Standaard)

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>]

Description

Voorbeelden

Voorbeeld 1: Een gebruiker maken met de 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

Voorbeeld 2: Een gebruiker maken met de parameter AgeGroup

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

Voorbeeld 3: Een gebruiker maken met de 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

Voorbeeld 4: Een gebruiker maken met de parameter Afdeling

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

Voorbeeld 5: Een gebruiker maken met de 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

Parameters

-AccountEnabled

Geeft aan of het account van de gebruiker is ingeschakeld.

Parametereigenschappen

Parametersets

-AgeGroup

Hiermee geeft u de leeftijdsgroep van de gebruiker.

Parametereigenschappen

Parametersets

-BusinessPhones

Hiermee geeft u een telefoonnummer.

Parametereigenschappen

Parametersets

-City

Hiermee geeft u de plaats van de gebruiker.

Parametereigenschappen

Parametersets

-CompanyName

Hiermee geeft u de bedrijfsnaam van de gebruiker.

Parametereigenschappen

Parametersets

-ConsentProvidedForMinor

Hiermee stelt u in of toestemming is verkregen voor minderjarigen.

Parametereigenschappen

Parametersets

-Country

Hiermee geeft u het land van de gebruiker.

Parametereigenschappen

Parametersets

-CreationType

Geeft aan of het gebruikersaccount een lokaal account is voor een Microsoft Entra ID B2C-tenant. Mogelijke waarden zijn 'LocalAccount' en null.

• Wanneer de gebruiker een lokaal account maakt, is de eigenschap vereist en moet u deze instellen op LocalAccount.
• Wanneer de gebruiker een werk- of schoolaccount maakt, geeft u de eigenschap niet op of stelt u deze in op null.

Parametereigenschappen

Parametersets

-Department

Hiermee geeft u de afdeling van de gebruiker.

Parametereigenschappen

Parametersets

-DisplayName

Hiermee geeft u de weergavenaam van de gebruiker.

Parametereigenschappen

Parametersets

-FaxNumber

Hiermee geeft u het faxnummer van de gebruiker.

Parametereigenschappen

Parametersets

-GivenName

Hiermee geeft u de opgegeven naam van de gebruiker.

Parametereigenschappen

Parametersets

-ImmutableId

Deze eigenschap koppelt een on-premises gebruikersaccount aan het bijbehorende Microsoft Entra ID-object en is vereist bij het maken van een nieuwe gebruiker in Microsoft Graph als de UPN (userPrincipalName) van de gebruiker zich in een federatief domein bevindt.

Belangrijk: De tekens $ en _ kunnen niet worden gebruikt bij het opgeven van deze eigenschap.

Parametereigenschappen

Parametersets

-JobTitle

Hiermee geeft u de functie van de gebruiker.

Parametereigenschappen

Parametersets

-MailNickName

Hiermee geeft u de e-mailbijnaam van de gebruiker.

Parametereigenschappen

Parametersets

-Mobile

Hiermee geeft u het mobiele telefoonnummer van de gebruiker.

Parametereigenschappen

Parametersets

-OtherMails

Een lijst met andere e-mailadressen voor de gebruiker; bijvoorbeeld: 'bob@contoso.com', 'Robert@fabrikam.com'.

Parametereigenschappen

Parametersets

-PasswordPolicies

Hiermee geeft u wachtwoordbeleid voor de gebruiker op. Deze waarde is een opsomming waarbij één mogelijke waarde 'DisableStrongPassword' is, waardoor zwakkere wachtwoorden kunnen worden opgegeven dan het standaardbeleid. 'DisablePasswordExpiration' kan ook worden opgegeven. De twee kunnen samen worden opgegeven; bijvoorbeeld: "DisablePasswordExpiration, DisableStrongPassword".

Parametereigenschappen

Parametersets

-PasswordProfile

Hiermee geeft u het wachtwoordprofiel van de gebruiker.

Het parametertype voor deze parameter is PasswordProfile.

Als u een parameter van dit type wilt doorgeven, moet u eerst een variabele maken in PowerShell met dat type:

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

Vervolgens kunt u doorgaan met het instellen van de waarde van het wachtwoord in deze variabele:

$passwordProfile.Password = "<Password>"

En ten slotte kunt u deze variabele doorgeven aan de cmdlet:

New-EntraUser -PasswordProfile $passwordProfile ...

Andere kenmerken die in het PasswordProfile kunnen worden ingesteld, zijn

• $passwordProfile.EnforceChangePasswordPolicy: een booleaanse waarde die aangeeft dat het wachtwoordbeleid voor wijzigen is uitgeschakeld voor deze gebruiker $passwordProfile.

• ForceChangePasswordNextLogin - een Booleaanse waarde die aangeeft dat de gebruiker het wachtwoord moet wijzigen bij de volgende aanmelding.

Parametereigenschappen

Parametersets

-PostalCode

Hiermee geeft u de postcode van de gebruiker.

Parametereigenschappen

Parametersets

-PreferredLanguage

Hiermee geeft u de voorkeurstaal van de gebruiker.

Parametereigenschappen

Parametersets

-ShowInAddressList

Als waar, wordt deze gebruiker weergegeven in de adreslijst.

Parametereigenschappen

Parametersets

-SignInNames

Hiermee geeft u de verzameling van aanmeldingsnamen voor een lokaal account in een Microsoft Entra ID B2C-tenant.

Elke aanmeldingsnaam moet uniek zijn binnen het bedrijf/de tenant.

De eigenschap moet worden opgegeven wanneer u een lokale accountgebruiker maakt; geef deze niet op wanneer u een werk- of schoolaccount maakt.

Parametereigenschappen

Parametersets

-State

Hiermee geeft u de status van de gebruiker.

Parametereigenschappen

Parametersets

-StreetAddress

Hiermee geeft u het adres van de gebruiker.

Parametereigenschappen

Parametersets

-Surname

Hiermee geeft u de achternaam van de gebruiker.

Parametereigenschappen

Parametersets

-UsageLocation

Een landcode van twee letters (ISO-standaard 3166).

Vereist voor gebruikers waaraan licenties zijn toegewezen vanwege wettelijke vereisten om te controleren op beschikbaarheid van services in landen.

Voorbeelden zijn: 'US', 'JP' en 'GB'.

Parametereigenschappen

Parametersets

-UserPrincipalName

De UPN (User Principal Name) van de gebruiker.

De UPN is een aanmeldingsnaam in internetstijl voor de gebruiker op basis van de internetstandaard RFC 822.

Deze UPN moet standaard worden toegewezen aan de e-mailnaam van de gebruiker.

De algemene indeling is 'alias@domain'.

Voor werk- of schoolaccounts moet het domein aanwezig zijn in de verzameling geverifieerde domeinen van de tenant.

Deze eigenschap is vereist wanneer een werk- of schoolaccount wordt gemaakt; dit is optioneel voor lokale accounts.

Parametereigenschappen

Parametersets

-UserState

Voor een externe gebruiker die is uitgenodigd voor de tenant met behulp van de uitnodigings-API, vertegenwoordigt deze eigenschap de status van de uitnodiging van de uitgenodigde gebruiker.

Parametereigenschappen

Parametersets

-UserStateChangedOn

Geeft de tijdstempel weer voor de meest recente wijziging in de eigenschap userState.

Parametereigenschappen

Parametersets

-UserType

Een tekenreekswaarde die kan worden gebruikt om gebruikerstypen in uw directory te classificeren, zoals 'Lid' en 'Gast'.

Parametereigenschappen

Parametersets

CommonParameters

Verwante koppelingen

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