Mettre à jour un utilisateurUpdate user

Mettez à jour les propriétés d’un objet utilisateur.Update the properties of a user object.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) User.ReadWrite, User.ReadWrite.All, Directory.ReadWrite.All, Directory.AccessAsUser.AllUser.ReadWrite, User.ReadWrite.All, Directory.ReadWrite.All, Directory.AccessAsUser.All
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) User.ReadWriteUser.ReadWrite
ApplicationApplication User.ReadWrite.All, Directory.ReadWrite.AllUser.ReadWrite.All, Directory.ReadWrite.All

Lors de la mise à jour de la propriété passwordProfile, l’autorisation suivante est requise : Directory.AccessAsUser.All.When updating the passwordProfile property, the following permission is required: Directory.AccessAsUser.All.

Requête HTTPHTTP request

PATCH /users/{id | userPrincipalName}

En-têtes de demandeRequest headers

En-têteHeader ValeurValue
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

Corps de la demandeRequest body

Dans le corps de la demande, fournissez les valeurs pour les champs appropriés qui doivent être mis à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conserveront leurs valeurs précédentes ou seront recalculées en fonction des modifications apportées à d’autres valeurs des propriétés. Pour de meilleures performances, n’incluez pas de valeurs existantes qui n’ont pas changé.In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

PropriétéProperty TypeType DescriptionDescription
aboutMeaboutMe StringString Champ de saisie de texte libre où l’utilisateur peut se décrire.A freeform text entry field for the user to describe themselves.
accountEnabledaccountEnabled BooléenBoolean valeur true si le compte est activé ; sinon, valeur false. Cette propriété est requise lorsqu’un utilisateur est créé. Prend en charge $filter.true if the account is enabled; otherwise, false. This property is required when a user is created. Supports $filter.
birthdaybirthday DateTimeOffsetDateTimeOffset Date d’anniversaire de l’utilisateur. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, minuit UTC le 1er janvier 2014 se présente comme suit : '2014-01-01T00:00:00Z'The birthday of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
Villecity StringString Ville dans laquelle se trouve l’utilisateur. Prend en charge $filter.The city in which the user is located. Supports $filter.
payscountry StringString Pays/région où se trouve l’utilisateur ; par exemple, « USA » ou « Royaume-Uni ». Prend en charge $filter.The country/region in which the user is located; for example, “US” or “UK”. Supports $filter.
Servicedepartment StringString Nom du service où travaille l’utilisateur. Prend en charge $filter.The name for the department in which the user works. Supports $filter.
displayNamedisplayName StringString Nom de l’utilisateur affiché dans le carnet d’adresses. Il s’agit généralement de la combinaison du prénom de l’utilisateur, de l’initiale de son deuxième prénom et de son nom. Cette propriété est requise lors de la création d’un utilisateur et ne peut pas être désactivée lors des mises à jour. Prend en charge $filter et $orderby.The name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial and last name. This property is required when a user is created and it cannot be cleared during updates. Supports $filter and $orderby.
givenNamegivenName StringString Prénom de l’utilisateur. Prend en charge $filter.The given name (first name) of the user. Supports $filter.
hireDatehireDate DateTimeOffsetDateTimeOffset Date d’embauche de l’utilisateur. Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, minuit UTC le 1er janvier 2014 se présente comme suit : '2014-01-01T00:00:00Z'The hire date of the user. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: '2014-01-01T00:00:00Z'
interestsinterests String collectionString collection Liste où l’utilisateur peut décrire ses centres d’intérêt.A list for the user to describe their interests.
jobTitlejobTitle StringString Fonction de l’utilisateur. Prend en charge $filter.The user’s job title. Supports $filter.
mailNicknamemailNickname StringString Alias de messagerie de l’utilisateur. Cette propriété doit être spécifiée lors de la création d’un utilisateur. Prend en charge $filter.The mail alias for the user. This property must be specified when a user is created. Supports $filter.
mobilePhonemobilePhone StringString Numéro de téléphone portable principal de l’utilisateur.The primary cellular telephone number for the user.
mySitemySite StringString URL du site personnel de l’utilisateur.The URL for the user's personal site.
officeLocationofficeLocation StringString Emplacement du bureau de l’utilisateur dans l’entreprise.The office location in the user's place of business.
onPremisesImmutableIdonPremisesImmutableId StringString Cette propriété sert à associer un compte utilisateur Active Directory local à l’objet utilisateur Azure AD. Cette propriété doit être spécifiée lors de la création d’un compte d’utilisateur dans Microsoft Graph si vous utilisez un domaine fédéré pour la propriété userPrincipalName (UPN) de l’utilisateur. Important : vous ne pouvez pas utiliser les caractères $ et _ pour nommer cette propriété. Prend en charge $filter.This property is used to associate an on-premises Active Directory user account to their Azure AD user object. This property must be specified when creating a new user account in the Graph if you are using a federated domain for the user’s userPrincipalName (UPN) property. Important: The $ and _ characters cannot be used when specifying this property. Supports $filter.
passwordPoliciespasswordPolicies StringString Spécifie les stratégies de mot de passe de l’utilisateur. Cette valeur est une énumération avec une seule valeur possible, « DisableStrongPassword », qui permet de spécifier des mots de passe plus faibles que la stratégie par défaut. La valeur « DisablePasswordExpiration » peut également être spécifiée. Il également possible de spécifier les deux valeurs ensemble, par exemple : « DisablePasswordExpiration, DisableStrongPassword ».Specifies password policies for the user. This value is an enumeration with one possible value being “DisableStrongPassword”, which allows weaker passwords than the default policy to be specified. “DisablePasswordExpiration” can also be specified. The two may be specified together; for example: "DisablePasswordExpiration, DisableStrongPassword".
passwordProfilepasswordProfile PasswordProfilePasswordProfile Spécifie le profil du mot de passe de l’utilisateur. Le profil contient le mot de passe de l’utilisateur. Cette propriété est requise lorsqu’un utilisateur est créé. Le mot de passe du profil doit respecter les exigences minimales spécifiées par la propriété passwordPolicies. Par défaut, un mot de passe fort est requis.Specifies the password profile for the user. The profile contains the user’s password. This property is required when a user is created. The password in the profile must satisfy minimum requirements as specified by the passwordPolicies property. By default, a strong password is required.
pastProjectspastProjects String collectionString collection Liste où l’utilisateur peut énumérer les projets qu’il a réalisés.A list for the user to enumerate their past projects.
postalCodepostalCode StringString Code postal de l’adresse de l’utilisateur. Le code postal est spécifique au pays/à la région de l’utilisateur. Aux États-Unis d’Amérique, cet attribut contient le code ZIP.The postal code for the user's postal address. The postal code is specific to the user's country/region. In the United States of America, this attribute contains the ZIP code.
preferredLanguagepreferredLanguage StringString Langue par défaut de l’utilisateur. Doit respecter le Code ISO 639-1 ; par exemple « fr-FR ».The preferred language for the user. Should follow ISO 639-1 Code; for example "en-US".
responsibilitiesresponsibilities String collectionString collection Liste où l’utilisateur peut énumérer ses responsabilités.A list for the user to enumerate their responsibilities.
schoolsschools String collectionString collection Liste où l’utilisateur peut énumérer les écoles qu’il a fréquentées.A list for the user to enumerate the schools they have attended.
skillsskills String collectionString collection Liste où l’utilisateur peut énumérer ses compétences.A list for the user to enumerate their skills.
statestate StringString Département ou province où habite l’utilisateur. Prend en charge $filter.The state or province in the user's address. Supports $filter.
streetAddressstreetAddress StringString Adresse postale de l’entreprise de l’utilisateur.The street address of the user's place of business.
surnamesurname StringString Nom de l’utilisateur (nom de famille). Prend en charge $filter.The user's surname (family name or last name). Supports $filter.
usageLocationusageLocation StringString Code pays à deux lettres (norme ISO 3166). Obligatoire pour les utilisateurs qui recevront des licences en raison d’une obligation légale qui exige la vérification de la disponibilité des services dans les pays. Exemples : « US », « JP » et « GB ». Ne peut accepter une valeur null. Prend en charge $filter.A two letter country code (ISO standard 3166). Required for users that will be assigned licenses due to legal requirement to check for availability of services in countries. Examples include: "US", "JP", and "GB". Not nullable. Supports $filter.
userPrincipalNameuserPrincipalName StringString Nom d’utilisateur principal (UPN) de l’utilisateur. Le nom UPN est le nom de connexion Internet de l’utilisateur défini conformément à la norme Internet RFC 822. Par convention, il doit être mappé sur le nom de messagerie de l’utilisateur. Le format général est alias@domaine, où le domaine doit être présent dans la collection de domaines vérifiés du client. Cette propriété est requise lorsqu’un utilisateur est créé. Les domaines vérifiés du client sont accessibles à partir de la propriété verifiedDomains de l’organisation. Prend en charge $filter et $orderby.The user principal name (UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is alias@domain, where domain must be present in the tenant’s collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the verifiedDomains property of organization. Supports $filter and $orderby.
userTypeuserType StringString Valeur de chaîne qui peut être utilisée pour classer les types d’utilisateur dans votre répertoire, tels que « Membre » et « Invité ». Prend en charge $filter.A string value that can be used to classify user types in your directory, such as “Member” and “Guest”. Supports $filter.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 204 No Content.If successful, this method returns a 204 No Content response code.

ExempleExample

DemandeRequest

Voici un exemple de demande.Here is an example of the request.

PATCH https://graph.microsoft.com/v1.0/me
Content-type: application/json
Content-length: 491

{
  "accountEnabled": true,
  "businessPhones": [
    "businessPhones-value"
  ],
  "city": "city-value"
}
RéponseResponse

Voici un exemple de réponse.Here is an example of the response.

HTTP/1.1 204 No Content

Exemple de code SDKSDK sample code


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var businessPhonesList = new List<String>();
businessPhonesList.Add( "businessPhones-value" );

var user = new User
{
    AccountEnabled = true,
    BusinessPhones = businessPhonesList,
    City = "city-value",
};

await graphClient.Me
    .Request()
    .UpdateAsync(user);

Pour plus d’informations sur la façon d' Ajouter le kit de développement logiciel (SDK) à votre projet et de créer une instance authProvider , consultez la documentation SDK .Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.