ユーザーの employeeLeaveDateTime プロパティを構成する

この記事では、ユーザーの employeeLeaveDateTime 属性を構成する方法について説明 します。 このプロパティは、 ライフサイクル ワークフローを使用して作成された "leaver" ワークフローのトリガーとして使用できます。

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。

アクセス許可の種類	最小特権アクセス許可	特権の高いアクセス許可
委任 (職場または学校のアカウント)	User.Read.All と User-LifeCycleInfo.ReadWrite.All	注意事項なし。
委任 (個人用 Microsoft アカウント)	サポートされていません。	サポートされていません。
アプリケーション	User.Read.All と User-LifeCycleInfo.ReadWrite.All	注意事項なし。

委任されたシナリオの場合、管理者はグローバル管理者Microsoft Entraロールも持っている必要があります。

注:

この情報は、HR プロビジョニング、Microsoft Entra Connect、またはカスタム同期ソリューションを使用して、自動化によって最適に更新されます。 このプロセスの詳細については、「 ライフサイクル ワークフローの属性を同期する方法」を参照してください。

要求

次の例では、2022 年 9 月 30 日の 23:59 を、ユーザーがorganizationから退出する日時として構成します。

HTTP

PATCH https://graph.microsoft.com/v1.0/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 "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

関連コンテンツ

• ライフサイクル ワークフロー API の概要
• ライフサイクル ワークフローの属性を同期する方法