Set-AzureADUser

Référence

Module:: AzureAD

Met à jour un utilisateur.

Syntax

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.Displayname

Exemple 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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-City

Spécifie la ville de l’utilisateur.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-Country

Spécifie le pays ou la région de l’utilisateur.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-Department

Spécifie le service de l’utilisateur.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisplayName

Spécifie le nom complet de l’utilisateur.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-FacsimileTelephoneNumber

Numéro de télécopie de l’utilisateur.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GivenName

Spécifie le nom donné de l’utilisateur.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-IsCompromised

True si cet utilisateur est compromis

Type:	Boolean
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JobTitle

Spécifie le poste de l’utilisateur.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-PasswordProfile

Spécifie le profil de mot de passe de l’utilisateur.

Type:	PasswordProfile
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-PostalCode

Spécifie le code postal de l’utilisateur.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PreferredLanguage

Spécifie la langue par défaut de l’utilisateur.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-State

Spécifie l’état de l’utilisateur.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StreetAddress

Spécifie l’adresse postale de l’utilisateur.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Surname

Spécifie le nom de famille de l’utilisateur.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-UserPrincipalName

Spécifie le nom d’utilisateur principal de l’utilisateur.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

Notes

Consultez le guide de migration de Set-AzureADUser vers Microsoft Graph PowerShell.

Partager via