Share via


New-AzureADUser

Crea un utente di Active Directory.

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 (AD).

Esempio

Esempio 1: creare un utente

-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

{{ Fill AgeGroup Description }}

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

{{ Fill CompanyName Description }}

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

-ConsentProvidedForMinor

{{ Fill ConsentProvidedForMinor Description }}

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, la proprietà è obbligatoria e deve essere impostata 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

@{Text=}

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

-FacsimileTelephoneNumber

{{Fill FacsimileTelephoneNumber Description}}

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 durante la creazione di un nuovo account utente in Graph se si usa un dominio federato per la proprietà userPrincipalName (UPN) dell'utente.

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

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 di lavoro 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 possibile valore "DisableStrongPassword" il quale supporta password più vulnerabili rispetto ai criteri predefiniti da specificare. È possibile specificare anche il valore "DisablePasswordExpiration". 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 creare un vairable in PowerShell con quel tipo:

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

È possibile procedere quindi per impostare il valore della password nella variabile:

$PasswordProfile.Password = "<Password>"

Infine, è possibile passare questa variabile al cmdlet :

New-AzureADUser -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 questo utente $PasswordProfile.ForceChangePasswordNextLogin, valore booleano che indica che l'utente deve modificare la password al successivo accesso

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

-PhysicalDeliveryOfficeName

Specifica il nome dell'ufficio di consegna 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 account locale, ma non 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 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 a due lettere (standard ISO 3166). Obbligatorio per gli utenti a cui verranno assegnate le licenze a causa del requisito legale per verificare la disponibilità dei servizi in paesi e aree geografiche. Alcuni esempi: "US", "JP" e "GB".

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

-UserPrincipalName

Nome dell'entità utente (UPN) dell'utente. 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@dominio". 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

{{ Compilare la descrizione userstate }}

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

-UserStateChangedOn

{{ Fill UserStateChangedOn Description }}

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