Set-AzureADUser

  • Riferimento
Modulo:
AzureAD

Esegue l'aggiornamento di un utente.

Sintassi

Set-AzureADUser
   -ObjectId <String>
   [-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 Set-AzureADUser aggiorna un utente in Azure Active Directory (AD).

Esempio

Esempio 1: Aggiornare un utente

PS C:\> $user = Get-AzureADUser -ObjectId TestUser@example.com 
PS C:\> $user.DisplayName = 'YetAnotherTestUser' 
PS C:\> Set-AzureADUser -ObjectId TestUser@example.com -Displayname $user.Displayname

Esempio 2: Impostare tutti gli utenti ma specificati come minori con il consenso dei genitori

Get-AzureADUser -All $true | 
Where-Object -FilterScript { $_.DisplayName -notmatch '(George|James|Education)' } | 
ForEach-Object  { Set-AzureADUser -ObjectId $($_.ObjectId) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }

Questo comando aggiorna la proprietà dell'utente specificato.

Parametri

-AccountEnabled

Indica se l'account è abilitato.

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

-AgeGroup

Usato dalle applicazioni aziendali per determinare il gruppo di età legale dell'utente. Questa proprietà è di sola lettura e calcolata in base alle proprietà ageGroup e consentProvidedForMinor . Valori consentiti: null, notAdultminore adult. Fare riferimento alle [definizioni di proprietà del gruppo di età legale][Altre informazioni sulle definizioni di gruppo di età e di consenso secondario].

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

-City

Specifica la città dell'utente.

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

-CompanyName

Nome dell'azienda 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.

Tipo:String
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, deniedgrantede notRequired. Per altre informazioni, vedere [definizioni di proprietà del gruppo di età legale][Altre informazioni sulle definizioni di età e di consenso minore].

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

-Country

Specifica il paese o l'area geografica dell'utente.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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, la proprietà è obbligatoria e deve essere impostata su "LocalAccount". Quando si crea un account aziendale o dell'istituto di istruzione, non specificare la proprietà o impostarla su null.

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

-Department

Specifica il reparto dell'utente.

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

-DisplayName

Specifica il nome visualizzato dell'utente.

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

-ExtensionProperty

Aggiungere dati alle proprietà utente personalizzate come estensioni aperte di base o più versatili esnsazioni dello schema. Vedere [altre informazioni sulle estensioni][Altre informazioni sulle estensioni].

Tipo:Dictionary<TKey,TValue>[System.String,System.String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FacsimileTelephoneNumber

Numero di fax dell'utente.

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

-GivenName

Specifica il nome specificato dall'utente.

Tipo:String
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 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à UPN dell'utente userPrincipalName . Importante: Impossibile utilizzare i $ caratteri e _ quando si specifica questa proprietà.

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

-IsCompromised

True se l'utente è compromesso

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

-JobTitle

Specifica il titolo del processo dell'utente.

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

-MailNickName

Specifica un soprannome per l'indirizzo di posta elettronica dell'utente.

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

-Mobile

Specifica il numero di telefono cellulare dell'utente.

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

-ObjectId

Specifica l'ID di un utente (come UPN o ObjectId) in Azure AD.

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

-OtherMails

Specifica altri indirizzi di posta elettronica per l'utente.

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

-PasswordPolicies

Specifica i criteri della password per l'utente.

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

-PasswordProfile

Specifica il profilo password dell'utente.

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

-PhysicalDeliveryOfficeName

Posizione dell'ufficio nel luogo di lavoro dell'utente. La lunghezza massima è di 128 caratteri.

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

-PostalCode

Specifica il codice postale dell'utente.

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

-PreferredLanguage

Specifica la lingua preferita dell'utente.

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

-ShowInAddressList

Impostare su True per visualizzare l'utente nell'elenco indirizzi.

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

-SignInNames

Elenco dei nomi di accesso per questo utente

Tipo:List<T>[Microsoft.Open.AzureAD.Model.SignInName]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-State

Specifica lo stato dell'utente.

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

-StreetAddress

Specifica l'indirizzo di strada dell'utente.

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

-Surname

Specifica il cognome dell'utente.

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

-TelephoneNumber

Specifica il numero di telefono dell'utente.

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

-UsageLocation

Codice paese o area geografica di due lettere (standard ISO 3166). Obbligatorio per gli utenti che verranno assegnate licenze a causa del requisito legale per verificare la disponibilità dei servizi nei paesi e nelle aree geografiche. Alcuni esempi: "US", "JP" e "GB". Non ammette i valori NULL.

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

-UserPrincipalName

Specifica il nome dell'entità utente dell'utente.

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

-UserState

Per un utente esterno invitato al tenant usando l'API di invito, questa proprietà rappresenta lo stato dell'invito dell'utente invitato. Per gli utenti invitati, lo stato può essere PendingAcceptance o Acceptednull o per tutti gli altri utenti.

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

-UserStateChangedOn

Mostra il timestamp per la modifica più recente alla proprietà externalUserState.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
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 "Member" e "Guest".

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

Note

Vedere la guida alla migrazione per Set-AzureADUser su Microsoft Graph PowerShell.