Configurar a propriedade employeeLeaveDateTime para um usuário

Este artigo descreve como configurar o atributo employeeLeaveDateTime para um usuário. Essa propriedade pode ser usada como um gatilho para fluxos de trabalho "abandonadores" criados usando Fluxos de Trabalho do Ciclo de Vida.

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Para cenários delegados, o administrador também deve ter a função de Administrador Global do Microsoft Entra.

Definir a propriedade employeeLeaveDateTime

O exemplo a seguir configura 30 de setembro de 2022 às 23:59 como a data e a hora em que o usuário deixará a organização. A solicitação retorna um 204 No Content código de resposta.

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

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

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

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

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

Redefinir a propriedade employeeLeaveDateTime de volta para nulo

A solicitação retorna o código de resposta 204 No Content.

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

{
    "employeeLeaveDateTime": null
}

Conteúdo relacionado

• Visão geral da API de Fluxos de Trabalho do Ciclo de Vida
• Tutorial: Como sincronizar atributos para fluxos de trabalho do Ciclo de Vida