Partager via


Configurer la propriété employeeLeaveDateTime pour un utilisateur

Cet article explique comment configurer l’attribut employeeLeaveDateTime pour un utilisateur. Cette propriété peut être utilisée comme déclencheur pour les workflows « leaver » créés à l’aide de workflows de cycle de vie.

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) User.Read.All et User-LifeCycleInfo.ReadWrite.All Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application User.Read.All et User-LifeCycleInfo.ReadWrite.All Non disponible.

Pour les scénarios délégués, l’administrateur doit également avoir le rôle Administrateur général Microsoft Entra.

Remarque

Il est préférable de mettre à jour ces informations via l’automatisation à l’aide d’une solution de provisionnement RH, de Microsoft Entra Connect ou de synchronisation personnalisée. Pour plus d’informations sur ce processus, consultez Comment synchroniser les attributs pour les workflows de cycle de vie.

Définir la propriété employeeLeaveDateTime

Demande

L’exemple suivant configure le 30 septembre 2022 à 23:59 comme date et heure auxquelles l’utilisateur quittera le organization.

PATCH https://graph.microsoft.com/v1.0/users/aaaaaaaa-bbbb-cccc-1111-222222222222

{
    "employeeLeaveDateTime": "2022-09-30T23:59:59Z"
}

Rétablir la valeur Null de la propriété employeeLeveDateTime

La requête retourne un code de réponse 204 No Content .

PATCH https://graph.microsoft.com/v1.0/users/aaaaaaaa-bbbb-cccc-1111-222222222222

{
    "employeeLeaveDateTime": null
}