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 DisableStrongPassword
consente 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;
- creare una variabile in PowerShell con tale tipo:
$PasswordProfile = New-Object -TypeName Microsoft.Open.AzureAD.Model.PasswordProfile
- Impostare il valore della password in questa variabile:
$PasswordProfile.Password = "\<Password\>"
- 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
, JP
e 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.