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 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".
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 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.
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
, JP
e 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.
Collegamenti correlati
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per