New-EntraUser

Sintassi

Default (Impostazione predefinita)

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

Descrizione

Esempio

Esempio 1: Creare un utente usando il parametro 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

Esempio 2: Creare un utente usando il parametro 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

Esempio 3: Creare un utente usando il parametro 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

Esempio 4: Creare un utente usando il parametro 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

Esempio 5: Creare un utente usando il parametro 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

Parametri

-AccountEnabled

Indica se l'account dell'utente è abilitato.

Proprietà dei parametri

Set di parametri

-AgeGroup

Specifica il gruppo di età dell'utente.

Proprietà dei parametri

Set di parametri

-BusinessPhones

Specifica un numero di telefono.

Proprietà dei parametri

Set di parametri

-City

Specifica la città dell'utente.

Proprietà dei parametri

Set di parametri

-CompanyName

Specifica il nome della società dell'utente.

Proprietà dei parametri

Set di parametri

-ConsentProvidedForMinor

Imposta se è stato ottenuto il consenso per i minori.

Proprietà dei parametri

Set di parametri

-Country

Specifica il paese dell'utente.

Proprietà dei parametri

Set di parametri

-CreationType

Indica se l'account utente è un account locale per un tenant Microsoft Entra ID B2C. I valori possibili sono "LocalAccount" e Null.

• Quando l'utente crea un account locale, la proprietà è obbligatoria ed è necessario impostarla su "LocalAccount".
• Quando l'utente crea un account aziendale o dell'istituto di istruzione, non specificare la proprietà o impostarla su Null.

Proprietà dei parametri

Set di parametri

-Department

Specifica il reparto dell'utente.

Proprietà dei parametri

Set di parametri

-DisplayName

Specifica il nome visualizzato dell'utente.

Proprietà dei parametri

Set di parametri

-FaxNumber

Specifica il numero di fax dell'utente.

Proprietà dei parametri

Set di parametri

-GivenName

Specifica il nome specificato dall'utente.

Proprietà dei parametri

Set di parametri

-ImmutableId

Questa proprietà collega un account utente locale al relativo oggetto Microsoft Entra ID ed è necessario quando si crea un nuovo utente in Microsoft Graph se l'UPN (userPrincipalName) dell'utente si trova in un dominio federato.

Importante: i caratteri $ e _ non possono essere usati quando si specifica questa proprietà.

Proprietà dei parametri

Set di parametri

-JobTitle

Specifica il titolo di lavoro dell'utente.

Proprietà dei parametri

Set di parametri

-MailNickName

Specifica il nome alternativo di posta elettronica dell'utente.

Proprietà dei parametri

Set di parametri

-Mobile

Specifica il numero di telefono cellulare dell'utente.

Proprietà dei parametri

Set di parametri

-OtherMails

Elenco di altri indirizzi di posta elettronica per l'utente; ad esempio: "bob@contoso.com", "Robert@fabrikam.com".

Proprietà dei parametri

Set di parametri

-PasswordPolicies

Specifica i criteri password per l'utente. Questo valore è un'enumerazione con un valore possibile come "DisableStrongPassword", che consente di specificare password più deboli rispetto ai criteri predefiniti. È anche possibile specificare "DisablePasswordExpiration". I due possono essere specificati insieme; ad esempio: "DisablePasswordExpiration, DisableStrongPassword".

Proprietà dei parametri

Set di parametri

-PasswordProfile

Specifica il profilo password dell'utente.

Il tipo di parametro per questo parametro è "PasswordProfile".

Per passare un parametro di questo tipo, è prima necessario creare una variabile in PowerShell con tale tipo:

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

È quindi possibile procedere con l'impostazione del valore della password in questa variabile:

$passwordProfile.Password = "<Password>"

Infine, è possibile passare questa variabile al cmdlet :

New-EntraUser -PasswordProfile $passwordProfile ...

Altri attributi che possono essere impostati in PasswordProfile sono

• $passwordProfile.EnforceChangePasswordPolicy: valore booleano che indica che il criterio di modifica della password è inababled o disabilitato per l'utente $passwordProfile.

• ForceChangePasswordNextLogin: valore booleano che indica che l'utente deve modificare la password al successivo accesso.

Proprietà dei parametri

Set di parametri

-PostalCode

Specifica il codice postale dell'utente.

Proprietà dei parametri

Set di parametri

-PreferredLanguage

Specifica la lingua preferita dell'utente.

Proprietà dei parametri

Set di parametri

-ShowInAddressList

Se True, visualizzare l'utente nell'elenco indirizzi.

Proprietà dei parametri

Set di parametri

-SignInNames

Specifica la raccolta di nomi di accesso per un account locale in un tenant B2C Microsoft Entra ID.

Ogni nome di accesso deve essere univoco nell'azienda o nel tenant.

La proprietà deve essere specificata quando si crea un utente dell'account locale; non specificarlo quando si crea un account aziendale o dell'istituto di istruzione.

Proprietà dei parametri

Set di parametri

-State

Specifica lo stato dell'utente.

Proprietà dei parametri

Set di parametri

-StreetAddress

Specifica l'indirizzo dell'utente.

Proprietà dei parametri

Set di parametri

-Surname

Specifica il cognome dell'utente.

Proprietà dei parametri

Set di parametri

-UsageLocation

Codice paese a due lettere (standard ISO 3166).

Obbligatorio per gli utenti a cui sono assegnate licenze a causa del requisito legale di verificare la disponibilità dei servizi nei paesi.

Gli esempi includono: "US", "JP" e "GB".

Proprietà dei parametri

Set di parametri

-UserPrincipalName

Nome principale utente (UPN) dell'utente.

L'UPN è un nome di accesso in stile Internet per l'utente basato sullo standard Internet RFC 822.

Per convenzione, questo UPN deve essere mappato al nome di posta elettronica dell'utente.

Il formato generale è "alias@domain".

Per gli account aziendali o dell'istituto di istruzione, il dominio deve essere presente nella raccolta di domini verificati del tenant.

Questa proprietà è obbligatoria quando viene creato un account aziendale o dell'istituto di istruzione; è facoltativo per gli account locali.

Proprietà dei parametri

Set di parametri

-UserState

Per un utente esterno invitato al tenant usando l'API di invito, questa proprietà rappresenta lo stato di invito dell'utente invitato.

Proprietà dei parametri

Set di parametri

-UserStateChangedOn

Mostra il timestamp per la modifica più recente alla proprietà userState.

Proprietà dei parametri

Set di parametri

-UserType

Valore stringa che può essere usato per classificare i tipi utente nella directory, ad esempio "Membro" e "Guest".

Proprietà dei parametri

Set di parametri

CommonParameters

Collegamenti correlati

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