New-AzADUser

Modulo:

Az.Resources

Aggiunge una nuova entità agli utenti

Sintassi

New-AzADUser
   -DisplayName <String>
   -MailNickname <String>
   -UserPrincipalName <String>
   -Password <SecureString>
   [-AboutMe <String>]
   [-AccountEnabled <Boolean>]
   [-AgeGroup <String>]
   [-Birthday <DateTime>]
   [-City <String>]
   [-CompanyName <String>]
   [-ConsentProvidedForMinor <String>]
   [-Country <String>]
   [-DeletedDateTime <DateTime>]
   [-Department <String>]
   [-DeviceEnrollmentLimit <Int32>]
   [-EmployeeHireDate <DateTime>]
   [-EmployeeId <String>]
   [-EmployeeType <String>]
   [-ExternalUserState <String>]
   [-ExternalUserStateChangeDateTime <DateTime>]
   [-FaxNumber <String>]
   [-GivenName <String>]
   [-HireDate <DateTime>]
   [-Interest <String[]>]
   [-IsResourceAccount]
   [-JobTitle <String>]
   [-Mail <String>]
   [-MobilePhone <String>]
   [-MySite <String>]
   [-OfficeLocation <String>]
   [-ImmutableId <String>]
   [-OtherMail <String[]>]
   [-PasswordPolicy <String>]
   [-PostalCode <String>]
   [-PreferredLanguage <String>]
   [-PreferredName <String>]
   [-Responsibility <String[]>]
   [-School <String[]>]
   [-ShowInAddressList]
   [-Skill <String[]>]
   [-State <String>]
   [-StreetAddress <String>]
   [-Surname <String>]
   [-UsageLocation <String>]
   [-UserType <String>]
   [-ForceChangePasswordNextLogin]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzADUser
   -DisplayName <String>
   -MailNickname <String>
   -UserPrincipalName <String>
   [-AboutMe <String>]
   [-AccountEnabled <Boolean>]
   [-AgeGroup <String>]
   [-Birthday <DateTime>]
   [-City <String>]
   [-CompanyName <String>]
   [-ConsentProvidedForMinor <String>]
   [-Country <String>]
   [-DeletedDateTime <DateTime>]
   [-Department <String>]
   [-DeviceEnrollmentLimit <Int32>]
   [-EmployeeHireDate <DateTime>]
   [-EmployeeId <String>]
   [-EmployeeType <String>]
   [-ExternalUserState <String>]
   [-ExternalUserStateChangeDateTime <DateTime>]
   [-FaxNumber <String>]
   [-GivenName <String>]
   [-HireDate <DateTime>]
   [-Interest <String[]>]
   [-IsResourceAccount]
   [-JobTitle <String>]
   [-Mail <String>]
   [-MobilePhone <String>]
   [-MySite <String>]
   [-OfficeLocation <String>]
   [-ImmutableId <String>]
   [-OtherMail <String[]>]
   [-PasswordPolicy <String>]
   [-PostalCode <String>]
   [-PreferredLanguage <String>]
   [-PreferredName <String>]
   [-Responsibility <String[]>]
   [-School <String[]>]
   [-ShowInAddressList]
   [-Skill <String[]>]
   [-State <String>]
   [-StreetAddress <String>]
   [-Surname <String>]
   [-UsageLocation <String>]
   [-UserType <String>]
   -PasswordProfile <IMicrosoftGraphPasswordProfile>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Aggiunge una nuova entità agli utenti

Esempio

Esempio 1: Creare un utente con il profilo password

$password = "xxxxxxxxxx"
$pp = New-Object -TypeName "Microsoft.Azure.PowerShell.Cmdlets.Resources.MSGraph.Models.ApiV10.IMicrosoftGraphPasswordProfile" -Property @{Password=$password}
New-AzADUser -DisplayName $uname -PasswordProfile $pp -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upn

Creare un utente con il profilo password

Esempio 2: Creare un utente con password

$password = "xxxxxxxxxx"
$password = ConvertTo-SecureString -AsPlainText -Force $password
New-AzADUser -DisplayName $uname -Password $password -AccountEnabled $true -MailNickname $nickname -UserPrincipalName $upn

Creare un utente con password

Parametri

-AboutMe

Campo di immissione testo a mano libera che l'utente deve descrivere se stesso. Restituito solo in $select.

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

-AccountEnabled

true per abilitare l'account; in caso contrario, false.

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

-AgeGroup

Imposta il gruppo di età dell'utente. Valori consentiti: null, minor, notAdult e adult. Per altre informazioni, vedere le definizioni di proprietà del gruppo di età legale. Supporta $filter (eq, ne, NOT e in).

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

-Birthday

Compleanno dell'utente. Il tipo Timestamp rappresenta le informazioni di data e ora usando il formato ISO 8601 ed è sempre in formato UTC. Ad esempio, mezzanotte UTC il 1° gennaio 2014 è 2014-01-01T00:00:00Z restituito solo in $select.

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

-City

Città dell'utente. La lunghezza massima è di 128 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-CompanyName

Nome della società associato all'utente. Questa proprietà può essere utile per descrivere l'azienda da cui proviene un utente esterno. La lunghezza massima del nome della società è di 64 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConsentProvidedForMinor

Imposta se il consenso è stato ottenuto per i minori. Valori consentiti: null, concesso, negato e notRequired. Per altre informazioni, vedere le definizioni di proprietà del gruppo di età legale. Supporta $filter (eq, ne, NOT e in).

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

-Country

Paese/area geografica in cui si trova l'utente; ad esempio Stati Uniti o Regno Unito. La lunghezza massima è di 128 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Type:	PSObject
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeletedDateTime

.

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

-Department

Nome del reparto in cui lavora l'utente. La lunghezza massima è di 64 caratteri. Supporta $filter (operatori eq, ne, NOT , ge, le e in).

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

-DeviceEnrollmentLimit

Limite al numero massimo di dispositivi che l'utente può registrare. I valori consentiti sono 5 o 1000.

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

-DisplayName

Nome visualizzato nella rubrica dell'utente. Questo valore è in genere la combinazione del nome dell'utente, dell'iniziale centrale e del cognome. Questa proprietà è obbligatoria quando viene creato un utente e non può essere cancellata durante gli aggiornamenti. La lunghezza massima consentita è di 256 caratteri. Supporta $filter (eq, ne, NOT , ge, le, in, startsWith), $orderBy e $search.

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

-EmployeeHireDate

Data e ora in cui l'utente è stato assunto o inizierà il lavoro in caso di assunzione futura. Supporta $filter (eq, ne, NOT , ge, le, in).

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

-EmployeeId

Identificatore del dipendente assegnato all'utente dall'organizzazione. Supporta $filter (eq, ne, NOT , ge, le, in, startsWith).

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

-EmployeeType

Acquisisce il tipo di lavoro aziendale. Ad esempio, Employee, Contractor, Consultant o Vendor. Supporta $filter (eq, ne, NOT , ge, le, in, startsWith).

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

-ExternalUserState

Per un utente esterno invitato al tenant usando l'API di invito, questa proprietà rappresenta lo stato di invito dell'utente invitato. Per gli utenti invitati, lo stato può essere PendingAcceptance o Accepted o Null per tutti gli altri utenti. Supporta $filter (eq, ne, NOT , in).

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

-ExternalUserStateChangeDateTime

Mostra il timestamp per la modifica più recente alla proprietà externalUserState. Supporta $filter (eq, ne, NOT , in).

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

-FaxNumber

Numero fax dell'utente. Supporta $filter (eq, ne, NOT , ge, le, in, startsWith).

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

-ForceChangePasswordNextLogin

Deve essere specificato se l'utente deve modificare la password al successivo accesso riuscito (true). Il comportamento predefinito è (false) per non modificare la password al successivo accesso riuscito.

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

-GivenName

Nome (di battesimo) dell'utente. La lunghezza massima è di 64 caratteri. Supporta $filter (eq, ne, NOT , ge, le, in, startsWith).

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

-HireDate

Data di assunzione dell'utente. Il tipo Timestamp rappresenta le informazioni di data e ora usando il formato ISO 8601 ed è sempre in formato UTC. Ad esempio, mezzanotte UTC il 1 gennaio 2014 è 2014-01-01T00:00:00Z. Restituito solo in $select. Nota: questa proprietà è specifica di SharePoint Online. È consigliabile usare la proprietà employeeHireDate nativa per impostare e aggiornare i valori della data di assunzione usando le API Microsoft Graph.

Type:	DateTime
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 Active Directory locale all'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. NOTA: non è possibile utilizzare i caratteri $ e _ quando si specifica questa proprietà. Restituito solo in $select. Supporta $filter (eq, ne, NOT, ge, le, in)..

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

-Interest

Elenco per l'utente per descrivere i propri interessi. Restituito solo in $select.

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

-IsResourceAccount

Non usare : riservato per uso futuro.

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

-JobTitle

Posizione dell'utente. La lunghezza massima è di 128 caratteri. Supporta $filter (eq, ne, NOT , ge, le, in, startsWith).

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

-Mail

Indirizzo SMTP per l'utente, admin@contoso.comad esempio . Le modifiche apportate a questa proprietà aggiorneranno anche l'insieme proxyAddresses dell'utente in modo da includere il valore come indirizzo SMTP. Anche se questa proprietà può contenere caratteri accenti, l'uso può causare problemi di accesso con altre applicazioni Microsoft per l'utente. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith).

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

-MailNickname

Alias di posta elettronica dell'utente. Questa proprietà deve essere specificata quando viene creato un utente. La lunghezza massima è di 64 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-MobilePhone

Numero di telefono cellulare principale dell'utente. Sola lettura per gli utenti sincronizzati dalla directory locale. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-MySite

URL del sito personale dell'utente. Restituito solo in $select.

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

-OfficeLocation

Posizione dell'ufficio nel luogo di lavoro dell'utente. La lunghezza massima è di 128 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-OtherMail

Elenco di indirizzi di posta elettronica aggiuntivi per l'utente; ad esempio: ['bob@contoso.com', 'Robert@fabrikam.com']. NOTA: sebbene questa proprietà possa contenere caratteri accenti, può causare problemi di accesso alle applicazioni proprietarie per l'utente. Supporta $filter (eq, NOT, ge, le, in, startsWith).

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

-Password

Password per l'utente. Deve soddisfare i requisiti di complessità delle password del tenant. È consigliabile impostare una password complessa.

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

-PasswordPolicy

Specifica i criteri password per l'utente. Questo valore è un'enumerazione con un valore possibile, disableStrongPassword, che consente di specificare password più deboli rispetto ai criteri predefiniti. È anche possibile specificare DisablePasswordExpiration. I due possono essere specificati insieme; ad esempio: DisablePasswordExpiration, DisableStrongPassword.Supports $filter (ne, NOT).

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

-PasswordProfile

passwordProfile Per costruire, vedere la sezione NOTES per le proprietà PASSWORDPROFILE e creare una tabella hash.

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

-PostalCode

Il CAP dell'indirizzo postale dell'utente. Il CAP è specifico del Paese/della regione dell'utente. Nel Stati Uniti, questo attributo contiene il CAP. La lunghezza massima è di 40 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-PreferredLanguage

Lingua preferita per l'utente. Deve seguire il codice ISO 639-1; ad esempio en-US. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-PreferredName

Nome preferito per l'utente. Restituito solo in $select.

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

-Responsibility

Elenco per l'utente in cui enumerare le proprie responsabilità. Restituito solo in $select.

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

-School

Elenco per l'utente per enumerare le scuole che hanno frequentato. Restituito solo in $select.

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

-ShowInAddressList

true se l'elenco indirizzi globale di Outlook deve contenere l'utente, in caso contrario false. Se non è impostato, verrà considerato true. Per gli utenti invitati tramite gestione inviti, questa proprietà verrà impostata su false. Supporta $filter (eq, ne, NOT, in).

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

-Skill

Elenco per l'utente per enumerare le proprie competenze. Restituito solo in $select.

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

-State

Stato o provincia dell'utente. La lunghezza massima è di 128 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-StreetAddress

Indirizzo della sede di lavoro dell'utente. La lunghezza massima è di 1024 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-Surname

Cognome dell'utente. La lunghezza massima è di 64 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

-UsageLocation

Codice paese a due lettere (standard ISO 3166). Obbligatorio per gli utenti a cui verranno assegnate le licenze a causa del requisito legale di verificare la disponibilità dei servizi nei paesi. Gli esempi includono: US, JP e GB. Non ammette i valori NULL. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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 essere eseguito il mapping al nome di posta elettronica dell'utente. Il formato generale è alias@domain, dove il dominio deve essere presente nella raccolta di domini verificati del tenant. Questa proprietà è obbligatoria quando viene creato un utente. È possibile accedere ai domini verificati per il tenant dalla proprietà verifiedDomains dell'organizzazione. NOTA: sebbene questa proprietà possa contenere caratteri accenti, può causare problemi di accesso alle applicazioni proprietarie per l'utente. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith, endsWith) e $orderBy.

Type:	String
Position:	Named
Default value:	None
Required:	True
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 Membro e Guest. Supporta $filter (eq, ne, NOT, in, ).

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Output

IMicrosoftGraphUser

Note

ALIAS

PROPRIETÀ DEI PARAMETRI COMPLESSI

Per creare i parametri descritti di seguito, creare una tabella hash contenente le proprietà appropriate. Per informazioni sulle tabelle hash, eseguire get-help about_Hash_Tables.

PASSWORDPROFILE <IMicrosoftGraphPasswordProfile>: passwordProfile

• [(Any) <Object>]: indica che qualsiasi proprietà può essere aggiunta a questo oggetto.
• [ForceChangePasswordNextSignIn <Boolean?>]: true se l'utente deve modificare la password nel successivo account di accesso; in caso contrario false. Se non è impostato, il valore predefinito è false. NOTA: per i tenant di Azure B2C, impostare su false e usare invece criteri personalizzati e flussi utente per forzare la reimpostazione della password al primo accesso. Vedere Forzare la reimpostazione della password al primo accesso.
• [ForceChangePasswordNextSignInWithMfa <Boolean?>]: se true, all'accesso successivo, l'utente deve eseguire un'autenticazione a più fattori (MFA) prima di essere costretta a modificare la password. Il comportamento è identico a forceChangePasswordNextSignIn, ad eccezione del fatto che l'utente deve prima eseguire un'autenticazione a più fattori prima della modifica della password. Dopo una modifica della password, questa proprietà verrà reimpostata automaticamente su false. Se non è impostato, il valore predefinito è false.
• [Password <String>]: password per l'utente. Questa proprietà è obbligatoria quando viene creato un utente. Può essere aggiornato, ma l'utente dovrà modificare la password al successivo account di accesso. La password deve soddisfare i requisiti minimi specificati dalla proprietà passwordPolicies dell'utente. Per impostazione predefinita, è necessaria una password complessa.