Condividi tramite


New-AzADUser

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.

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à dell'utente. La lunghezza massima consentita è 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 consentita è 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

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare 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 lavora 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 consentita è 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 (di battesimo) dell'utente. La lunghezza massima consentita è 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 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

Posizione dell'utente. La lunghezza massima consentita è 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, 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).

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

-MailNickname

Alias di posta elettronica dell'utente. È necessario specificare questa proprietà al momento della creazione dell'utente. La lunghezza massima consentita è 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 principale dell'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 consentita è 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

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 consentita è 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 dell'utente. La lunghezza massima consentita è 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 della sede di lavoro 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. La lunghezza massima consentita è 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 ammette i valori NULL. 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 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.

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 gli effetti dell'esecuzione del cmdlet. 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

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.