Condividi tramite


New-AzureADUser

Crea un utente di Azure AD.

Sintassi

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

Descrizione

Il cmdlet New-AzureADUser crea un utente in Azure Active Directory (Azure AD).

Esempio

Esempio 1: creare un utente

$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
$PasswordProfile.Password = "<Password>"
New-AzureADUser -DisplayName "New User" -PasswordProfile $PasswordProfile -UserPrincipalName "NewUser@contoso.com" -AccountEnabled $true -MailNickName "Newuser"

ObjectId                             DisplayName UserPrincipalName               UserType
--------                             ----------- -----------------               --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user    NewUser@contoso.com             Member

Questo comando crea un nuovo utente.

Parametri

-AccountEnabled

Indica se l'account dell'utente è abilitato.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AgeGroup

Specifica il gruppo di età dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-City

Specifica la città dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CompanyName

In questo modo viene specificato il nome della società dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ConsentProvidedForMinor

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Country

Specifica il paese o l'area geografica dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CreationType

Indica se l'account utente è un account locale per un tenant di Azure Active Directory B2C.

I valori possibili sono LocalAccount e null. Quando si crea un account locale, è necessaria la proprietà e è necessario impostarla su LocalAccount. Quando si crea un account aziendale o dell'istituto di istruzione, non specificare la proprietà o impostarla su null.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Department

Specifica il reparto dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisplayName

Specifica il nome visualizzato dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExtensionProperty

Tipo:Dictionary<TKey,TValue>[System.String,System.String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FacsimileTelephoneNumber

In questo modo viene specificato il numero di telefono dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-GivenName

Specifica il nome specificato dall'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ImmutableId

Questa proprietà viene usata per associare un account utente locale di Active Directory al rispettivo oggetto utente di Azure AD. Questa proprietà deve essere specificata quando si crea un nuovo account utente in Graph se si usa un dominio federato per la proprietà userPrincipalName (UPN) dell'utente.

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IsCompromised

Indica se l'utente è compromesso.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobTitle

Specifica il titolo del processo dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MailNickName

Specifica il soprannome di posta elettronica dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Mobile

Specifica il numero di telefono cellulare dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OtherMails

Elenco di indirizzi di posta elettronica aggiuntivi per l'utente. Ad esempio, bob@contoso.com, Robert@fabrikam.com.

Tipo:List<T>[String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PasswordPolicies

Specifica i criteri della password per l'utente.

Questo valore è un'enumerazione con un valore possibile che DisableStrongPasswordconsente di specificare password più deboli rispetto ai criteri predefiniti. DisablePasswordExpiration può essere specificato anche. I due valori possono essere specificati contemporaneamente, ad esempio "DisablePasswordExpiration, DisableStrongPassword".

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PasswordProfile

Specifica il profilo password dell'utente. Si noti che il tipo di parametro per questo parametro è PasswordProfile. Per passare un parametro di questo tipo, è prima necessario;

  1. creare una variabile in PowerShell con tale tipo:

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

  1. Impostare il valore della password in questa variabile:

$PasswordProfile.Password = "\<Password\>"

  1. Passare infine questa variabile al cmdlet:

New-AzureADUser -PasswordProfile $PasswordProfile ...

Altri attributi che possono essere impostati nel PasswordProfile sono:

  • $PasswordProfile.EnforceChangePasswordPolicy - un booleano che indica che i criteri di modifica password sono abilitati o disabilitati per l'utente.
  • $PasswordProfile.ForceChangePasswordNextLogin - un booleano che indica che l'utente deve modificare la password all'accesso successivo.
Tipo:PasswordProfile
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PhysicalDeliveryOfficeName

Specifica il nome dell'ufficio di recapito fisico dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PostalCode

Specifica il codice postale dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PreferredLanguage

Specifica la lingua preferita dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ShowInAddressList

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

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SignInNames

Specifica la raccolta di nomi di accesso per un account locale in un tenant di Azure Active Directory B2C.

Ogni nome di accesso deve essere univoco a livello di società/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.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-State

Specifica lo stato dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-StreetAddress

Specifica l'indirizzo di strada dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Surname

Specifica il cognome dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TelephoneNumber

Specifica un numero di telefono.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UsageLocation

Codice paese o area geografica di due lettere (standard ISO 3166).

È necessario per gli utenti che verranno assegnate licenze a causa dei requisiti legali per verificare la disponibilità dei servizi nei paesi e nelle aree geografiche. Esempi includono: US, JPe GB.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserPrincipalName

Specifica il nome dell'entità dell'utente (UPN).

L'UPN è un nome di accesso Internet per un utente basato sullo standard Internet RFC 822. Per convenzione, deve eseguire il mapping 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 si crea un account aziendale o dell'istituto di istruzione ed è facoltativa per gli account locali.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserState

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserStateChangedOn

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserType

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Note

Vedere la guida alla migrazione per New-AzureADUser in Microsoft Graph PowerShell.