Configuración de la propiedad employeeLeaveDateTime para un usuario

En este artículo se describe cómo configurar el atributo employeeLeaveDateTime para un usuario. Esta propiedad se puede usar como desencadenador para flujos de trabajo "leaver" creados mediante flujos de trabajo de ciclo de vida.

Permisos

Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso	Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa)	User.Read.All y User-LifeCycleInfo.ReadWrite.All
Delegado (cuenta personal de Microsoft)	No admitida.
Aplicación	User.Read.All y User-LifeCycleInfo.ReadWrite.All

Para escenarios delegados, el administrador también debe tener el rol De administrador global de Azure AD.

Solicitud

En el ejemplo siguiente se muestra un usuario que saldrá el 30 de septiembre de 2022 a las 23:59.

HTTP

PATCH https://graph.microsoft.com/beta/users/df744d9e-2148-4922-88a8-633896c1e929

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

PowerShell

    Connect-MgGraph -Scopes "User.Read.All","User-LifeCycleInfo.ReadWrite.All"
    Select-MgProfile -Name "beta"

    $UserId = "528492ea-779a-4b59-b9a3-b3773ef6da6d"
    $employeeLeaveDateTime = "2022-09-30T23:59:59Z"
    
    Update-MgUser -UserId $UserId -EmployeeLeaveDateTime $employeeLeaveDateTime

    $User = Get-MgUser -UserId $UserId
    $User.EmployeeLeaveDateTime

Pasos siguientes

• Información general sobre la API de flujos de trabajo de ciclo de vida
• Cómo sincronizar atributos para flujos de trabajo de ciclo de vida