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.

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AgeGroup

Specifica il gruppo di età dell'utente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-City

Specifica la città dell'utente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CompanyName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConsentProvidedForMinor

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Country

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Department

Specifica il reparto dell'utente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

Specifica il nome visualizzato dell'utente.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ExtensionProperty

Type:Dictionary<TKey,TValue>[System.String,System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FacsimileTelephoneNumber

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GivenName

Specifica il nome specificato dall'utente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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à.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IsCompromised

Indica se l'utente è compromesso.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobTitle

Specifica il titolo del processo dell'utente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MailNickName

Specifica il soprannome di posta elettronica dell'utente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Mobile

Specifica il numero di telefono cellulare dell'utente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OtherMails

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

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.
Type:PasswordProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PhysicalDeliveryOfficeName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PostalCode

Specifica il codice postale dell'utente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PreferredLanguage

Specifica la lingua preferita dell'utente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShowInAddressList

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-State

Specifica lo stato dell'utente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StreetAddress

Specifica l'indirizzo di strada dell'utente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Surname

Specifica il cognome dell'utente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TelephoneNumber

Specifica un numero di telefono.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserState

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserStateChangedOn

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserType

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Note

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