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 = ConvertTo-SecureString -String "****" -AsPlainText -Force
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.

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

-AccountEnabled

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

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

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

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

-City

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

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

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

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

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:	PSObject
Alias:	AzContext, AzureRmContext, AzureCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DeletedDateTime

.

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

-Department

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

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

-DeviceEnrollmentLimit

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

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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 è di 256 caratteri. Supporta $filter (eq, ne, NOT , ge, le, in, startsWith), $orderBy e $search.

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

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

-EmployeeId

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

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

-EmployeeType

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

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

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

-ExternalUserStateChangeDateTime

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

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

-FaxNumber

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

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

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

-GivenName

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

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

Tipo:	DateTime
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 di 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)..

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

-Interest

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

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

-IsResourceAccount

Non usare : riservato per uso futuro.

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

-JobTitle

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

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

-Mail

Indirizzo SMTP per l'utente, ad esempio, admin@contoso.com. 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).

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

-MailNickname

Alias di posta elettronica per l'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).

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

-MobilePhone

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

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

-MySite

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

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

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

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

-Password

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

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

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

-PasswordProfile

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

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

-PostalCode

Codice postale per l'indirizzo postale dell'utente. Il codice postale è specifico del paese/area geografica dell'utente. Negli Stati Uniti d'America questo attributo contiene il codice POSTALE. La lunghezza massima è di 40 caratteri. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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

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

-PreferredName

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

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

-Responsibility

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

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

-School

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

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

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

-Skill

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

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

-State

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

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

-StreetAddress

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

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

-Surname

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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 nullable. Supporta $filter (eq, ne, NOT, ge, le, in, startsWith).

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 in stile Internet per l'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.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
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 Membro e Guest. Supporta $filter (eq, ne, NOT, in, ).

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

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

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

Output

IMicrosoftGraphUser