Set-AzureADUser
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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
, notAdult
minor
e adult
. Fare riferimento alle [definizioni di proprietà del gruppo di età legale][Altre informazioni sulle definizioni di gruppo di età e di consenso secondario].
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-City
Specifica la città dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
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
, denied
granted
e notRequired
. Per altre informazioni, vedere [definizioni di proprietà del gruppo di età legale][Altre informazioni sulle definizioni di età e di consenso minore].
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Country
Specifica il paese o l'area geografica dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Department
Specifica il reparto dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Specifica il nome visualizzato dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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].
Type: | Dictionary<TKey,TValue>[System.String,System.String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FacsimileTelephoneNumber
Numero di fax dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GivenName
Specifica il nome specificato dall'utente.
Type: | String |
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 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à.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsCompromised
True se l'utente è compromesso
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobTitle
Specifica il titolo del processo dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MailNickName
Specifica un soprannome per l'indirizzo di posta elettronica dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Mobile
Specifica il numero di telefono cellulare dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ObjectId
Specifica l'ID di un utente (come UPN o ObjectId) in Azure AD.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OtherMails
Specifica altri indirizzi di posta elettronica per l'utente.
Type: | List<T>[String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordPolicies
Specifica i criteri della password per l'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PasswordProfile
Specifica il profilo password dell'utente.
Type: | PasswordProfile |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PhysicalDeliveryOfficeName
Posizione dell'ufficio nel luogo di lavoro dell'utente. La lunghezza massima è di 128 caratteri.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PostalCode
Specifica il codice postale dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreferredLanguage
Specifica la lingua preferita dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShowInAddressList
Impostare su True per visualizzare l'utente nell'elenco indirizzi.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SignInNames
Elenco dei nomi di accesso per questo utente
Type: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-State
Specifica lo stato dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StreetAddress
Specifica l'indirizzo di strada dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Surname
Specifica il cognome dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TelephoneNumber
Specifica il numero di telefono dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPrincipalName
Specifica il nome dell'entità utente dell'utente.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 Accepted
null
o per tutti gli altri utenti.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserStateChangedOn
Mostra il timestamp per la modifica più recente alla proprietà externalUserState.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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 "Member" e "Guest".
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Note
Vedere la guida alla migrazione per Set-AzureADUser su Microsoft Graph PowerShell.
Collegamenti correlati
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per