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

Description

Exempel

Exempel 1: Skapa en användare med parametern 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

Exempel 2: Skapa en användare med parametern 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

Exempel 3: Skapa en användare med hjälp av parametern 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

Exempel 4: Skapa en användare med hjälp av parametern Department

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

Exempel 5: Skapa en användare med hjälp av parametern 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

Parametrar

-AccountEnabled

Anger om användarens konto är aktiverat.

Parameteregenskaper

Parameteruppsättningar

-AgeGroup

Anger användarens åldersgrupp.

Parameteregenskaper

Parameteruppsättningar

-BusinessPhones

Anger ett telefonnummer.

Parameteregenskaper

Parameteruppsättningar

-City

Anger användarens stad.

Parameteregenskaper

Parameteruppsättningar

-CompanyName

Anger användarens företagsnamn.

Parameteregenskaper

Parameteruppsättningar

-ConsentProvidedForMinor

Anger om medgivande har erhållits för minderåriga.

Parameteregenskaper

Parameteruppsättningar

-Country

Anger användarens land.

Parameteregenskaper

Parameteruppsättningar

-CreationType

Anger om användarkontot är ett lokalt konto för en Microsoft Entra ID B2C-klientorganisation. Möjliga värden är "LocalAccount" och null.

• När användaren skapar ett lokalt konto krävs egenskapen och du måste ange den till "LocalAccount".
• När användaren skapar ett arbets- eller skolkonto anger du inte egenskapen eller anger den till null.

Parameteregenskaper

Parameteruppsättningar

-Department

Anger användarens avdelning.

Parameteregenskaper

Parameteruppsättningar

-DisplayName

Anger användarens visningsnamn.

Parameteregenskaper

Parameteruppsättningar

-FaxNumber

Anger användarens faxnummer.

Parameteregenskaper

Parameteruppsättningar

-GivenName

Anger användarens förnamn.

Parameteregenskaper

Parameteruppsättningar

-ImmutableId

Den här egenskapen länkar ett lokalt användarkonto till dess Microsoft Entra ID-objekt och krävs när du skapar en ny användare i Microsoft Graph om användarens userPrincipalName (UPN) finns i en federerad domän.

Viktigt: Tecknen $ och _ kan inte användas när du anger den här egenskapen.

Parameteregenskaper

Parameteruppsättningar

-JobTitle

Anger användarens jobbrubrik.

Parameteregenskaper

Parameteruppsättningar

-MailNickName

Anger användarens e-postnamn.

Parameteregenskaper

Parameteruppsättningar

-Mobile

Anger användarens mobiltelefonnummer.

Parameteregenskaper

Parameteruppsättningar

-OtherMails

En lista över andra e-postadresser för användaren. till exempel: "bob@contoso.com", "Robert@fabrikam.com".

Parameteregenskaper

Parameteruppsättningar

-PasswordPolicies

Anger lösenordsprinciper för användaren. Det här värdet är en uppräkning där ett möjligt värde är "DisableStrongPassword", vilket gör att svagare lösenord än standardprincipen kan anges. "DisablePasswordExpiration" kan också anges. De två kan anges tillsammans. till exempel: "DisablePasswordExpiration, DisableStrongPassword".

Parameteregenskaper

Parameteruppsättningar

-PasswordProfile

Anger användarens lösenordsprofil.

Parametertypen för den här parametern är "PasswordProfile".

För att kunna skicka en parameter av den här typen måste du först skapa en variabel i PowerShell med den typen:

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

Sedan kan du fortsätta med att ange värdet för lösenordet i den här variabeln:

$passwordProfile.Password = "<Lösenord>"

Och slutligen kan du skicka den här variabeln till cmdleten:

New-EntraUser -PasswordProfile $passwordProfile ...

Andra attribut som kan anges i PasswordProfile är

• $passwordProfile.EnforceChangePasswordPolicy – ett booleskt värde som anger att principen för ändringslösenord är enababled eller inaktiverad för den här användaren $passwordProfile.

• ForceChangePasswordNextLogin – ett booleskt värde som anger att användaren måste ändra lösenordet vid nästa inloggning.

Parameteregenskaper

Parameteruppsättningar

-PostalCode

Anger användarens postnummer.

Parameteregenskaper

Parameteruppsättningar

-PreferredLanguage

Anger användarens föredragna språk.

Parameteregenskaper

Parameteruppsättningar

-ShowInAddressList

Om sant visas den här användaren i adresslistan.

Parameteregenskaper

Parameteruppsättningar

-SignInNames

Anger samlingen med inloggningsnamn för ett lokalt konto i en Microsoft Entra ID B2C-klientorganisation.

Varje inloggningsnamn måste vara unikt för företaget/klientorganisationen.

Egenskapen måste anges när du skapar en lokal kontoanvändare. ange det inte när du skapar ett arbets- eller skolkonto.

Parameteregenskaper

Parameteruppsättningar

-State

Anger användarens tillstånd.

Parameteregenskaper

Parameteruppsättningar

-StreetAddress

Anger användarens gatuadress.

Parameteregenskaper

Parameteruppsättningar

-Surname

Anger användarens efternamn.

Parameteregenskaper

Parameteruppsättningar

-UsageLocation

En landskod med två bokstäver (ISO-standard 3166).

Krävs för användare som har tilldelats licenser på grund av juridiska krav för att söka efter tillgänglighet för tjänster i länder.

Exempel är: "US", "JP" och "GB".

Parameteregenskaper

Parameteruppsättningar

-UserPrincipalName

Användarens huvudnamn (UPN).

UPN är ett inloggningsnamn i Internetstil för användaren baserat på Internetstandarden RFC 822.

Enligt konventionen bör detta UPN mappas till användarens e-postnamn.

Det allmänna formatet är "alias@domain".

För arbets- eller skolkonton måste domänen finnas i klientorganisationens samling av verifierade domäner.

Den här egenskapen krävs när ett arbets- eller skolkonto skapas. det är valfritt för lokala konton.

Parameteregenskaper

Parameteruppsättningar

-UserState

För en extern användare som bjudits in till klientorganisationen med hjälp av inbjudnings-API:et representerar den här egenskapen den inbjudna användarens inbjudningsstatus.

Parameteregenskaper

Parameteruppsättningar

-UserStateChangedOn

Visar tidsstämpeln för den senaste ändringen av egenskapen userState.

Parameteregenskaper

Parameteruppsättningar

-UserType

Ett strängvärde som kan användas för att klassificera användartyper i din katalog, till exempel "Medlem" och "Gäst".

Parameteregenskaper

Parameteruppsättningar

CommonParameters

Relaterade länkar

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