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 = 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à 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 |
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 |