Condividi tramite


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.

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

-AgeGroup

{{ Fill AgeGroup Description }}

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

{{ Fill CompanyName Description }}

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

-ConsentProvidedForMinor

{{ Fill ConsentProvidedForMinor Description }}

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, 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.

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

@{Text=}

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

{{Fill FacsimileTelephoneNumber Description}}

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: quando si specifica questa proprietà, i caratteri $ e _ non possono essere usati.

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.comRobert@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 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".

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 creare un vairable in PowerShell con tale 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 nel file PasswordProfile sono

$PasswordProfile.EnforceChangePasswordPolicy - un booleano che indica che il criterio della password di modifica è inababled o disabilitato per questo 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 account locale, ma non 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). Obbligatorio per gli utenti che verranno assegnate licenze a causa del requisito legale per verificare la disponibilità dei servizi nei paesi e nelle aree geografiche. Alcuni esempi: "US", "JP" e "GB".

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

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

-UserState

{{ Fill UserState Description }}

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

-UserStateChangedOn

{{ Fill UserStateChangedOn Description }}

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