Set-AzureADUser
Met à jour un utilisateur.
Syntaxe
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>] Description
L’applet de commande Set-AzureADUser met à jour un utilisateur dans Azure Active Directory (AD).
Exemples
Exemple 1 : Mettre à jour un utilisateur
PS C:\> $user = Get-AzureADUser -ObjectId TestUser@example.com
PS C:\> $user.DisplayName = 'YetAnotherTestUser'
PS C:\> Set-AzureADUser -ObjectId TestUser@example.com -Displayname $user.DisplaynameExemple 2 : Définir tous les utilisateurs sauf spécifiés comme mineurs avec le consentement parental
Get-AzureADUser -All $true |
Where-Object -FilterScript { $_.DisplayName -notmatch '(George|James|Education)' } |
ForEach-Object { Set-AzureADUser -ObjectId $($_.ObjectId) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }Cette commande met à jour la propriété de l’utilisateur spécifié.
Paramètres
-AccountEnabled
Indique si le compte est activé.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AgeGroup
Utilisé par les applications d’entreprise pour déterminer le groupe d’âge légal de l’utilisateur. Cette propriété est en lecture seule et calculée en fonction des propriétés ageGroup et consentProvidedForMinor . Valeurs autorisées : null, minoret adultnotAdult . Reportez-vous aux [définitions de propriété de groupe d’âge légal][En savoir plus sur les définitions des groupes d’âge et des consentements mineurs].
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-City
Spécifie la ville de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-CompanyName
Nom de la société à laquelle l’utilisateur est associé. Cette propriété peut être utile pour décrire la société d’où provient un utilisateur externe. La longueur maximale du nom de la société est de 64 caractères.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ConsentProvidedForMinor
Définit si le consentement a été obtenu pour les mineurs. Valeurs autorisées : null, grantedet notRequireddenied . Pour plus d’informations, reportez-vous aux [définitions de propriété de groupe d’âge légal][En savoir plus sur les définitions des groupes d’âge et des consentements mineurs].
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Country
Spécifie le pays ou la région de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-CreationType
Indique si le compte d’utilisateur est un compte local pour un locataire Azure Active Directory B2C. Les valeurs possibles sont « LocalAccount » et null. Lorsque vous créez un compte local, la propriété est obligatoire et vous devez la définir sur « LocalAccount ». Lorsque vous créez un compte professionnel ou scolaire, ne spécifiez pas la propriété et ne la définissez pas sur null.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Department
Spécifie le service de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DisplayName
Spécifie le nom complet de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ExtensionProperty
Ajoutez des données aux propriétés utilisateur personnalisées en tant qu’extensions ouvertes de base ou extensions de schéma plus polyvalentes. Consultez [en savoir plus sur les extensions][En savoir plus sur les extensions].
| Type: | Dictionary<TKey,TValue>[System.String,System.String] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-FacsimileTelephoneNumber
Numéro de télécopie de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-GivenName
Spécifie le nom donné de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ImmutableId
Cette propriété permet d’associer un compte d’utilisateur Active Directory sur site à son objet utilisateur Azure AD. Cette propriété doit être spécifiée lors de la création d’un compte d’utilisateur dans le Graphique si vous utilisez un domaine fédéré pour la propriété de l’utilisateur userPrincipalName (UPN).
Important: Les $ caractères et _ ne peuvent pas être utilisés lors de la spécification de cette propriété.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-IsCompromised
True si cet utilisateur est compromis
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-JobTitle
Spécifie le poste de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-MailNickName
Spécifie un surnom pour l’adresse de messagerie de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Mobile
Spécifie le numéro de téléphone mobile de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ObjectId
Spécifie l’ID d’un utilisateur (en tant qu’UPN ou ObjectId) dans Azure AD.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-OtherMails
Spécifie d’autres adresses e-mail pour l’utilisateur.
| Type: | List<T>[String] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PasswordPolicies
Spécifie les stratégies de mot de passe de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PasswordProfile
Spécifie le profil de mot de passe de l’utilisateur.
| Type: | PasswordProfile |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PhysicalDeliveryOfficeName
Emplacement du bureau de l’utilisateur. La longueur maximale est de 128 caractères.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PostalCode
Spécifie le code postal de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-PreferredLanguage
Spécifie la langue par défaut de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ShowInAddressList
Définissez sur True pour afficher cet utilisateur dans la liste d’adresses.
| Type: | Boolean |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SignInNames
Liste des noms de connexion pour cet utilisateur
| Type: | List<T>[Microsoft.Open.AzureAD.Model.SignInName] |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-State
Spécifie l’état de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-StreetAddress
Spécifie l’adresse postale de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Surname
Spécifie le nom de famille de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-TelephoneNumber
Spécifie le numéro de téléphone de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-UsageLocation
Un code de pays ou de région à deux lettres (norme ISO 3166). Obligatoire pour les utilisateurs qui se verront attribuer des licences en raison de l’obligation légale de vérifier la disponibilité des services dans les pays et les régions. Exemples : « US », « JP » et « GB ». N'accepte pas la valeur NULL.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-UserPrincipalName
Spécifie le nom d’utilisateur principal de l’utilisateur.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-UserState
Pour un utilisateur externe invité sur le locataire à l’aide de l’API d’invitation, cette propriété représente l’état de l’invitation de l’utilisateur invité. Pour les utilisateurs invités, l’état peut être PendingAcceptance ou Accepted, ou null pour tous les autres utilisateurs.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-UserStateChangedOn
Affiche l’horodatage de la dernière modification apportée à la propriété externalUserState.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-UserType
Valeur de chaîne qui permet de classer des types d’utilisateurs dans votre annuaire, tels que « Member » et « Guest ».
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Notes
Consultez le guide de migration de Set-AzureADUser vers Microsoft Graph PowerShell.