生命週期工作流程具有許多預先設定的工作,其目的在於自動化處理常見的生命週期管理情境。 您可以使用這些內建工作建立自訂工作流程,以符合貴組織的需求。 這些工作在幾秒內就能設定完畢,建立新的工作流程。 這些工作也有些類別是以「加入者、移動者、離開者」模型為基礎,以便根據需求輕鬆地排入工作流程之中。 在本文中,您會取得工作的完整清單、每個工作都有的一般參數資訊,以及每個特定工作所需的唯一參數清單。
支援的任務
生命週期工作流程的內建工作都包含識別碼,稱為 taskDefinitionID,而且可用來從頭開始建立新的工作流程,或插入工作流程範本,使其符合組織的需求。 如需生命週期工作流程適用範本的詳細資訊,請參閱:生命週期工作流程範本。
注意
生命週期工作流程透過自動化例行程序增強 Microsoft Entra ID 治理的人力資源驅動的布置。 雖然 HR 布建會管理用戶帳戶的建立和屬性更新,但生命週期工作流程會提供額外的工作自動化。
生命週期工作流程目前支援下列工作:
| 任務 | 任務定義ID (taskdefinitionID) | 類別 | Active Directory 相容性 |
|---|---|---|---|
| 向新進員工發送歡迎電子郵件 | 70b29d51-b59a-4773-9280-8841dfd3f2ea | 加入者 | |
| 傳送到職提醒電子郵件 | 3C860712-2D37-42A4-928F-5C93935D26A1 | 加入者 | |
| 選擇驗證設定檔進行身份驗證(預覽) | 9ed82537-8442-467a-8eef-9351fb7a1f9c |
加入者 | |
| 寄送主管驗證狀態電子郵件(預覽) | c7a1f3e5-4b2d-4e8a-9f6c-3d5a7b1e2c4f |
加入者 | |
| 選取 Verified ID 呈現方式的驗證(預覽) | 8314685b-de26-4c90-b086-bfa0e7a263f3 |
加入者 | |
| 產生臨時存取證並透過電子郵件寄給使用者的管理者 | 1b555e50-7f65-41d5-b514-5894a026d10d | 加入者 | |
| 發送電子郵件以通知管理員使用者異動 | AAB41899-9972-422A-9D97-F626014578B7 | 搬運工 | |
| 要求指派使用者存取套件 | c1ec1e76-f374-4375-aa6-0bb6bd4c60be | 加入者、移動者 | |
| 將授權指派給使用者 | 683c87a4-2ad4-420b-97d4-220d90afcd24 | 加入者、移動者 | |
| 將使用者新增至群組 | 22085229-5809-45e8-97fd-270d28d66910 | 加入者、離開者、移動者 | |
| 將使用者加入團隊 | E440ED8D-25A1-4618-84CE-091ED5BE5594 | 加入者、離開者、移動者 | |
| 更新使用者屬性 | 2c8f4a1b-7d3e-4f9c-8a5b-6e1d2c3f4a5b | 加入者、離開者、移動者 | |
| 啟用使用者帳戶 | 6fc52c9d-398b-4305-9763-15f42c1676fc | 加入者、離開者 | |
| 執行自訂任務擴充功能 | 4262b724-8dba-4fad-afc3-43fcbb497a0e | 加入者、離開者、移動者 | |
| 停用使用者帳戶 | 1dfdfcc7-52fa-4c2e-bf3a-e3919cc12950 | 離開者 | |
| 從選取群組中移除使用者 | 1953A66C-751C-45E5-8BFE-01462C70DA3C | 加入者、離開者、移動者 | |
| 從所有群組移除使用者 | B3A31406-2A15-4C9A-B25B-A658FA5F07FC | 離開者 | |
| 從所選團隊移除使用者 | 06aa7acb-01af-4824-8899-b14e5ed788d6 | 離開者 | |
| 將使用者從所有團隊中移除 | 81f7b200-2816-4b3b-8c5d-dc556f07b024 | 離開者 | |
| 移除使用者的存取套件指派 | 4a0b64f2-c7ec-46ba-b117-18f262946c50 | 離開者、移動者 | |
| 移除使用者的所有存取套件指派 | 42ae2956-193d-4f39-be06-691b8ac4fa1d | 離開者、移動者 | |
| 取消使用者的所有待處理存取套件指派要求 | 498770d9-bab7-4e4c-b73d-5ded82a1d0b3 | 離開者 | |
| 從使用者移除所選授權指派 | 5fc402a8-daaf-4b7b-9203-da868b05fc5f | 離開者、移動者 | |
| 撤銷使用者的所有刷新權杖 | 509589a4-0466-4471-829e-49c5e502bdee | 離開者、移動者 | |
| 寄電子郵件給主管,說明贊助變更 | b8c4e1f9-3a7d-4b2e-9c5f-8d6a9b1c2e3f | 離開者、移動者 | |
| 請寄電子郵件給共同贊助者,告知贊助者異動 | AD3B85CD-75B1-43E7-B4B9-0E52FABA3944 | 離開者、移動者 | |
| 將代理人身分贊助轉移給經理 | B8F4C3D5-9E7A-4B1C-8F2D-6A5E8B9C7F4A | 離開者、移動者 | |
| 移除使用者的所有授權指派 | 8FA97D28-3E52-4985-B3A9-A1126F9B8B4E | 離開者 | |
| 刪除使用者 | 8d18588d-9ad3-4c0f-99d0-ec215f0e3dff | 離開者 | |
| 在使用者最後一天之前寄送電子郵件給管理員 | 52853a3e-f4e5-4eb8-bb24-1ac09a1da935 | 離開者 | |
| 在使用者離職當天發送電子郵件 | 9c0a1eaf-5bda-4392-9d9e-6e155bb57411 | 離開者 | |
| 在使用者最後一天結束後,將電子郵件寄給使用者的經理 | 6f22ddd4-b3a5-47a4-a846-0d7c201a49ce | 離開者 | |
| 寄送電子郵件告知使用者未活動 | 92f74cb4-f1b6-4ec0-b766-96210f56edc2 | 離開者 | |
| 發送有關非贊助訪客移除的電子郵件(預覽) | a8e4c7f2-9d1b-4a3e-b5c6-8f2e7a9d4c1b | 離開者 |
通用工作參數
通用工作參數是每個工作都有的非專用參數。 將工作新增至新的工作流程或工作流程範本時,您可以自訂和設定這類參數,使其符合您的需求。
| 參數 | 定義 |
|---|---|
| 分類 | 用於識別任務類別的唯讀字串。 選擇 taskDefinitionID 時自動決定。 |
| 任務定義ID | 參考 taskDefinition 的字串,以決定要執行的任務。 |
| 已啟用 | 布林值表示任務是否設定為執行。 如果設定為 “true”, 則工作會執行。 預設設置為 true。 |
| 顯示名稱 | 可用來識別工作的特殊字串。 |
| 描述 | 字串,用於說明管理作業用途的工作目的。 (選擇性) |
| 執行順序 | 唯讀的整數,說明該工作在工作流程中的執行順序。 |
| continueOnError | 使用布林值來決定此工作的失敗是否會停止後續工作流程的運行。 |
| 引數 | 內含指定工作相關的唯一參數。 |
通用電子郵件工作參數
除了所有基本任務參數外,在 基礎 郵件任務中還包含設定郵件收件人的權限:
電子郵件的收件者可以是:
- Manager 郵件屬性(Preview):執行工作流程的使用者經理的電子郵件。
- 使用者郵件屬性(預設):執行工作流程的使用者電子郵件。
- 贊助者郵件屬性(預覽版):工作流程執行對象之使用者的贊助者電子郵件。
- 已選取的使用者(預覽):手動指定之使用者的電子郵件。
注意
僅當收件者是使用者本人或其經理時,才能添加其他的CC收件人。 如果有多個 CC 收件者,會在單一電子郵件上複製這些收件者。
在 電子郵件自訂 下,您可以自訂任務傳送的特定電子郵件訊息。 如果您選擇自訂電子郵件,您可以設定下列引數:
- 主旨:自訂電子郵件主旨。
- 訊息內容:自訂寄出電子郵件的正文,並可透過 HTML 元素進一步自訂。
- 電子郵件語言翻譯:覆寫電子郵件收件人的語言設定。 自訂文字尚未有效調整,建議您將此語言設定為與自訂文字相同的語言。
如需瞭解此流程的詳細步驟,請參閱:自訂工作流程任務發送的電子郵件。
電子郵件中的動態屬性
使用自訂電子郵件時,您可以在主旨和本文中包含動態屬性,將這些電子郵件個人化。 你可以包含內建的使用者屬性、自訂安全屬性、目錄擴充功能以及本地擴充功能屬性。 以下表格展示了可用的動態屬性範例:
使用者屬性
| 屬性 | 定義 |
|---|---|
{{user.displayName}} |
使用者的顯示名稱。 |
{{user.givenName}} |
使用者的名字。 |
{{user.userPrincipalName}} |
使用者的使用者主體名稱。 |
{{user.employeeHireDate}} |
使用者的員工入職日期。 |
{{user.employeeLeaveDateTime}} |
使用者的員工離職日期和時間。 |
{{user.createdDateTime}} |
使用者被創建的日期和時間。 |
{{user.employeeType}} |
使用者的員工類型。 |
{{user.department}} |
用戶部門。 |
{{user.companyName}} |
使用者的公司名稱。 |
{{user.jobTitle}} |
使用者的職稱。 |
{{temporaryAccessPass}} |
產生的臨時存取密碼。 僅適用於產生 TAP 並傳送電子郵件工作。 |
管理者屬性
| 屬性 | 定義 |
|---|---|
{{managerDisplayName}} |
使用者管理員的顯示名稱。 |
{{managerEmail}} |
經理的電子郵件。 |
擴充功能與自訂屬性
| 屬性 | 定義 |
|---|---|
{{user.employeeOrgData/costCenter}} |
使用者成本中心,來自員工組織資料。 |
{{user.employeeOrgData/division}} |
員工組織資料中的使用者部門。 |
{{user.customSecurityAttributes/attributeSet/attributeName}} |
一個自訂的安全屬性值。 將 attributeSet 和 attributeName 替換為您的屬性集和屬性名稱。 |
{{user.onPremisesExtensionAttributes/extensionAttribute1}} |
一個本地擴充屬性。 替換 extensionAttribute1 為所需的屬性編號(1-15)。 |
注意
在為自訂電子郵件或主旨添加這些屬性時,必須以 {{user.graphPropertyName}} 正確的語法格式化。 如需執行這項操作的逐步指南,請參閱:設定自訂電子郵件中的屬性格式。
重要
新的 {{user.graphPropertyName}} 屬性格式適用於新的自訂電子郵件任務。 在這次變更前已設定的工作流程中現有的客製化電子郵件任務不受影響,並繼續使用其現有的屬性格式。
作業詳細資料
本節包含每項特定工作,以及參數和必要條件等詳細資訊,需要這些資訊才能順利執行。 這些參數如同時出現在 Microsoft Entra 系統管理中心和 Microsoft Graph 中,將會加以註明。 如需一般編輯生命週期工作流程工作的詳細資訊,請參閱:管理工作流程版本。
傳送歡迎電子郵件給新進員工
生命週期工作流程可讓您將歡迎電子郵件自動化傳送給組織中的新進員工。 您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
執行傳送歡迎電子郵件給新進員工工作的 Microsoft Entra 必要條件如下:
- 已填入的使用者電子郵件屬性。
若為 Microsoft Graph,傳送歡迎電子郵件給新進員工工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 加入者 |
| 顯示名稱 | 傳送歡迎電子郵件 (使用者自訂) |
| 描述 | 傳送歡迎電子郵件給新進員工 (使用者自訂) |
| 任務定義ID | 70b29d51-b59a-4773-9280-8841dfd3f2ea |
| 引數 | 可選的 常見電子郵件任務參數 可以指定;如果沒有包含在內,預設行為就會生效。 |
工作流程中的使用範例:
{
"category": "joiner",
"continueOnError": false,
"description": "Send welcome email to new hire",
"displayName": "Send Welcome Email",
"isEnabled": true,
"taskDefinitionId": "70b29d51-b59a-4773-9280-8841dfd3f2ea",
"arguments": [
{
"name": "cc",
"value": "e94ad2cd-d590-4b39-8e46-bb4f8e293f85,ac17d108-60cd-4eb2-a4b4-084cacda33f2"
},
{
"name": "customSubject",
"value": "Welcome to the organization {{userDisplayName}}!"
},
{
"name": "customBody",
"value": "Welcome to our organization {{userGivenName}} {{userSurname}}.\n\nFor more information, reach out to your manager {{managerDisplayName}} at {{managerEmail}}."
},
{
"name": "locale",
"value": "en-us"
}
]
}
傳送上線提醒電子郵件
生命週期工作流程可讓您將上線提醒電子郵件自動傳送給組織中新進員工的主管。 您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
執行傳送入職提醒電子郵件任務的 Microsoft Entra 先決條件包括以下條件:
- 已填入的使用者主管屬性。
- 已填入的使用者主管電子郵件屬性。
若為 Microsoft Graph,傳送入職提醒電子郵件工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 加入者 |
| 顯示名稱 | 傳送上線提醒電子郵件 (使用者可自訂) |
| 描述 | 傳送上線提醒電子郵件給使用者的主管 (使用者可自訂) |
| 任務定義ID | 3C860712-2D37-42A4-928F-5C93935D26A1 |
| 引數 | 可選的 常見電子郵件任務參數 可以指定;如果沒有包含在內,預設行為就會生效。 |
工作流程中的使用範例:
{
"category": "joiner",
"continueOnError": false,
"description": "Send onboarding reminder email to user\u2019s manager",
"displayName": "Send onboarding reminder email",
"isEnabled": true,
"taskDefinitionId": "3C860712-2D37-42A4-928F-5C93935D26A1",
"arguments": [
{
"name": "cc",
"value": "e94ad2cd-d590-4b39-8e46-bb4f8e293f85,068fa0c1-fa00-4f4f-8411-e968d921c3e7"
},
{
"name": "customSubject",
"value": "Reminder: {{userDisplayName}} is starting soon"
},
{
"name": "customBody",
"value": "Hello {{managerDisplayName}}\n\nthis is a reminder that {{userDisplayName}} is starting soon.\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}
選擇用於身分驗證的驗證設定檔(預覽)
此任務會選擇一個身份驗證設定檔,並在入職前階段向使用者發送身份驗證電子郵件。 它包含在 聘前身份驗證啟動(預覽) 範本中。
您可以在Microsoft Entra 系統管理中心中自訂任務名稱與描述。 該任務會顯示為工作流程所選取的 已驗證 ID 設定檔 。 若要選取或變更該設定檔,請使用工作流程中的 「選擇身份驗證設定檔 」頁面。
執行「 選擇身份驗證設定檔(預覽) 」任務的先決條件為:
- 為工作流程選擇的 ID 驗證設定檔,其目的設定為
all或onboarding。 關於設定檔,請參閱 「建立 ID 驗證設定檔」。 - 使用者已填入的
otherMails屬性,包含使用者可存取的電子郵件地址。
預設電子郵件設定為「收件人」為「使用者」(預設),收件人為「其他郵件」收件人電子郵件地址屬性。 您也可以選擇 CC 收件人。
重要
發送至使用者 otherMails 電子郵件地址的聘用前身分驗證連結,會透過電子郵件一次性密碼(OTP)加以保護。 在目前版本中, otherMails 是此任務唯一支援且建議使用的收件電子郵件地址屬性。 其他自訂延伸屬性可以出現在 「收件人電子郵件地址」屬性中,但這些屬性不支援電子郵件 OTP 保護。 請使用 otherMails 而非自訂擴充屬性。
注意
您可以在 「電子郵件自訂」 中自訂電子郵件主旨、訊息內容及語言。 詳細資訊請參閱 「常見電子郵件任務參數 」及 「自訂從工作流程任務寄送的電子郵件」。
此任務僅在 Microsoft Graph /beta中可用,而非 /v1.0。 請參閱生命週期工作流程概覽(測試版)。
對於 Microsoft Graph,選取用於身分驗證的驗證設定檔(預覽)任務的參數如下:
| 參數 | 定義 |
|---|---|
| 類別 | joiner |
| displayName | 選擇驗證設定檔進行身分驗證(預覽)(可依使用者自訂) |
| 描述 | 選擇身分驗證設定檔,並將驗證電子郵件傳送給使用者(可由使用者自訂) |
| taskDefinitionId | 9ed82537-8442-467a-8eef-9351fb7a1f9c |
| 引數 |
verifiedIdProfileId、to,以及常見的電子郵件參數 cc、customSubject、customBody 和 locale。 請參閱下方的參數說明及 常見電子郵件任務參數。 |
所有引數值都是字串。
| Argument | 定義 |
|---|---|
| verifiedIdProfileId | 為工作流程所選擇的 ID 驗證設定檔的 ID。 |
| 到 |
User/otherMails。 將驗證連結傳送至使用者的 otherMails 電子郵件地址。 |
| cc | 一個使用者 ID 或以逗號分隔的使用者 ID 清單,用於在電子郵件中抄送。 |
| customSubject | 自訂電子郵件主旨。 |
| customBody | 自訂電子郵件訊息內容。 |
| 地區設定 | 一個覆蓋收件人語言設定的語言值。 |
工作流程任務的 JSON 範本:
以所選設定檔的 ID 取代 <id-verification-profile-id>。 範例中會選擇 User/otherMails 使用者作為收件者、 otherMails 電子郵件地址屬性,以及 en-us 電子郵件語言。
{
"category": "joiner",
"continueOnError": false,
"description": "Select an identity verification profile and send the verification email to the user",
"displayName": "Select verification profile for identity verification (Preview)",
"isEnabled": true,
"taskDefinitionId": "9ed82537-8442-467a-8eef-9351fb7a1f9c",
"arguments": [
{
"name": "verifiedIdProfileId",
"value": "<id-verification-profile-id>"
},
{
"name": "to",
"value": "User/otherMails"
},
{
"name": "locale",
"value": "en-us"
}
]
}
寄送經理驗證狀態電子郵件(預覽版)
此任務會寄送一封關於員工驗證狀態的電子郵件給使用者的主管。 它已包含於 到職前身分驗證啟動 (預覽) 和 含身分驗證的新進員工到職流程 (預覽) 這兩個範本中。
您可以在Microsoft Entra 系統管理中心中自訂任務名稱與描述。 此任務會顯示工作流程所選取的 已驗證 ID 設定檔。 若要選取或變更該設定檔,請使用工作流程中的 「選擇身份驗證設定檔」 頁面。
執行 「傳送管理員驗證狀態電子郵件(預覽) 」任務的先決條件為:
- 為工作流程選擇的 ID 驗證設定檔,其目的設定為
all或onboarding。 - 對於預設的管理者收件者,使用者的已填充
manager屬性以及該管理者的已填充mail屬性。
預設電子郵件設定為 管理員(預設)(用於 收件者)以及 mail(用於 收件者電子郵件地址屬性)。 您也可以選擇 CC 收件人。
注意
您可以在「電子郵件自訂」中自訂電子郵件主旨、訊息內容及語言。 詳細資訊請參閱 「常見電子郵件任務參數 」及 「自訂從工作流程任務寄送的電子郵件」。
此任務僅在 Microsoft Graph /beta中可用,而不在/v1.0中。 請參閱 生命週期工作流程概覽(Beta 版)。
對於 Microsoft Graph,傳送管理員驗證狀態電子郵件(預覽)任務的參數如下:
| 參數 | 定義 |
|---|---|
| 類別 | joiner |
| displayName | 寄送經理驗證狀態電子郵件(預覽)(可依使用者自訂) |
| 描述 | 向經理發送關於員工驗證狀態的通知電子郵件(可依使用者自訂) |
| taskDefinitionId | c7a1f3e5-4b2d-4e8a-9f6c-3d5a7b1e2c4f |
| 引數 |
verifiedIdProfileId、 to,以及常見的電子郵件參數 cc、 customSubject、 customBody、 locale。 請參閱下方的參數說明及 常見電子郵件任務參數。 |
所有參數值都是字串。
| Argument | 定義 |
|---|---|
| verifiedIdProfileId | 為工作流程所選擇的 ID 驗證設定檔的 ID。 |
| 到 |
User、Manager、Sponsors,或特定使用者的 ID({UserId}在任務定義中)。 範例使用 Manager,與管理中心的預設收件者相符。 |
| cc | 一個使用者 ID 或以逗號分隔的使用者 ID 清單,表示要在電子郵件中副本收件的對象。 |
| customSubject | 自訂電子郵件主旨。 |
| customBody | 自訂電子郵件訊息內容。 |
| 地區設定 | 一個覆蓋收件人語言設定的語言值。 |
工作流程任務的 JSON 範本:
以所選設定檔的 ID 替換 <id-verification-profile-id> 。 範例中將 en-us 作為收件者,並將 Manager 作為電子郵件語言。
{
"category": "joiner",
"continueOnError": false,
"description": "Send manager notification email about employee verification status",
"displayName": "Send manager verification status email (Preview)",
"isEnabled": true,
"taskDefinitionId": "c7a1f3e5-4b2d-4e8a-9f6c-3d5a7b1e2c4f",
"arguments": [
{
"name": "verifiedIdProfileId",
"value": "<id-verification-profile-id>"
},
{
"name": "to",
"value": "Manager"
},
{
"name": "locale",
"value": "en-us"
}
]
}
選取 Verified ID 出示驗證(預覽版)
此任務會寄送連結給使用者,讓其出示根據透過安全合作夥伴完成的政府核發身分證件驗證所建立的 Verified ID。 它包含於 新進員工到職訓練與身分驗證(預覽) 範本中。
當適用的通行金鑰設定檔啟用 Enforce attestation 時,iOS 上不支援透過此任務進行內嵌通行金鑰註冊;也不支援 Android 工作設定檔的通行金鑰註冊。 在 Android 上,內嵌流程會使用 Microsoft Authenticator 個人設定檔中的已驗證 ID,並將通行金鑰註冊在該設定檔,而非工作設定檔。 對於符合資格的帳戶,請改用現有的 TAP 任務,並搭配建議用於註冊的條件式存取保護。 請參閱 「選擇第一天註冊路徑」。
內部或外部訪客帳戶均不支援內嵌通行金鑰註冊。 目前的預覽版本並未改變此 通行金鑰訪客限制。
您可以在Microsoft Entra 系統管理中心中自訂任務名稱與描述。 該任務會顯示為工作流程所選取的 已驗證 ID 設定檔 。 若要選取或變更該設定檔,請使用工作流程中的 「選擇身份驗證設定檔 」頁面。
執行 「選擇已驗證 ID 出示(預覽)」任務的先決條件為:
- 為工作流程選擇的 ID 驗證設定檔,其目的設定為
all或onboarding。 如需設定設定檔,請參閱 《建立 ID 驗證設定檔》。 - 使用者的已填入
otherMails屬性,包含使用者可存取的電子郵件地址。
預設電子郵件設定中,收件者的預設值為 使用者(預設),而 收件者電子郵件地址屬性的預設值為 otherMails。 您也可以選擇 CC 收件人。
重要
傳送到使用者 otherMails 地址的 Verified ID 展示連結,其存取會以電子郵件一次性密碼(OTP)受到保護。 在目前版本中, otherMails 是此任務唯一支援且建議使用的收件電子郵件地址屬性。 其他自訂延伸屬性可以出現在 「收件人電子郵件地址」屬性中,但這些屬性不支援電子郵件 OTP 保護。 請使用 otherMails 而非自訂擴充屬性。
注意
您可以在 「電子郵件自訂」中自訂電子郵件主旨、訊息內容及語言。 詳細資訊請參閱 「常見電子郵件任務參數」 及 「自訂從工作流程任務寄送的電子郵件」。
此任務僅在 Microsoft Graph /beta中可用,而非 /v1.0。 請參閱生命週期工作流程概覽(測試版)。
對於 Microsoft Graph,選取已驗證 ID 呈現的驗證(預覽)任務的參數如下:
| 參數 | 定義 |
|---|---|
| 類別 | joiner |
| displayName | 選擇 Verified ID 呈現的驗證(預覽版)(可由使用者自訂) |
| 描述 | 傳送連結,以根據透過安全合作夥伴完成的政府身分識別驗證發出 Verified ID 出示要求(可由使用者自訂) |
| taskDefinitionId | 8314685b-de26-4c90-b086-bfa0e7a263f3 |
| 引數 |
verifiedIdProfileId、 to,以及常見的電子郵件參數 cc、 customSubject、 customBody 和 locale。 請參閱下方的參數說明及 常見電子郵件任務參數。 |
所有參數值都是字串。
| Argument | 定義 |
|---|---|
| verifiedIdProfileId | 為工作流程所選擇的 ID 驗證設定檔的 ID。 |
| 到 |
User/otherMails。 將驗證連結傳送至使用者 otherMails 的地址。 |
| cc | 一個使用者 ID 或以逗號分隔的使用者 ID 清單,在電子郵件中設為副本收件者。 |
| customSubject | 自訂電子郵件主旨。 |
| customBody | 自訂電子郵件訊息內容。 |
| 地區設定 | 一個覆蓋收件人語言設定的語言值。 |
工作流程任務的 JSON 範本:
以所選設定檔的 ID 替換 <id-verification-profile-id> 。 範例中會選擇 User/otherMails 使用者作為收件者、 otherMails 電子郵件地址屬性,以及 en-us 電子郵件語言。
{
"category": "joiner",
"continueOnError": false,
"description": "Send link to prompt a Verified ID presentation request based on Government ID verification done via the Security Partner",
"displayName": "Select verification for Verified ID presentation (Preview)",
"isEnabled": true,
"taskDefinitionId": "8314685b-de26-4c90-b086-bfa0e7a263f3",
"arguments": [
{
"name": "verifiedIdProfileId",
"value": "<id-verification-profile-id>"
},
{
"name": "to",
"value": "User/otherMails"
},
{
"name": "locale",
"value": "en-us"
}
]
}
產生臨時存取密碼,並透過電子郵件傳送給使用者的主管
Microsoft Entra 可讓您使用 暫時存取通行證 (TAP) 來為使用者設定無密碼認證。 您也可以使用 Microsoft Entra 自助式密碼重設 來設定一般密碼。 透過此任務,生命週期工作流程可以自動產生 TAP 並寄送給所選收件人。 任務目錄名稱指的是寄送給管理者,但您也可以選擇使用者作為收件人。
若要將 TAP 傳送給使用者,請在基本下將收件人設為使用者,並將收件人電子郵件地址屬性設為otherMails。 使用者屬性 otherMails 必須包含使用者可存取的電子郵件地址。 更新 工作描述,以反映會將通行證傳送給使用者,例如:「產生 Temporary Access Pass,並透過電子郵件傳送給使用者。」您可以在 電子郵件自訂 底下自訂電子郵件。
如需了解員工到職第一天使用 TAP 作為內嵌通行金鑰註冊替代方案的相關設定,請參閱 設定受身分驗證保護註冊的 TAP。 建議的配置會針對 註冊安全性資訊 使用含有 要求身分驗證 的條件式存取原則。 使用 TAP 替代方式不需要此原則;僅傳送 TAP 並不會構成身分驗證。
注意
使用者的員工雇用日期會做為臨時存取密碼的開始時間。 請確定 TAP 生命週期任務設定和 使用者聘用日期的時間部分 已適當設定,以便 TAP 在使用者開始第一天時仍然有效。 如果在工作流程執行時,雇用日期已過,則會使用目前時間作為開始時間。
在 Microsoft Entra 系統管理中心使用此工作時,可以為工作提供名稱和描述。 您也必須設定:
- 啟用期間-密碼有效的時間。
-
一次性使用——如果密碼只能使用一次。
執行 Microsoft Entra 工作之必要條件,使用 產生臨時存取密碼,並透過電子郵件傳送給使用者的主管,如下:
- 若要傳送給管理者,使用者必須已填入
manager關聯,且管理者必須已填入mail屬性。 - 若要以預設電子郵件內文傳送至
User/otherMails,則為使用者設定已填manager入的關聯。mail經理的屬性並非必需。 - 對於投遞至
User/otherMails且具有自訂電子郵件主體的情況,已填入manager關聯的預設主體要求不適用。 - 必須啟用 TAP 租戶政策,並且為啟用期間和一次性使用選取的值必須在政策的允許範圍內。 如需詳細資訊,請參閱啟用臨時存取密碼原則
重要
在工作流程中執行此工作的使用者,也必須不具任何其他驗證方法、登入或 Microsoft Entra 角色指派,這項工作才能運作。
TAP 帳戶類型的限制與電子郵件傳送無關。 內部訪客帳號可以被簽發 TAP,但外部訪客帳號無法在資源租戶中簽發 TAP。 請參閱 TAP 訪客存取 ,了解帳戶類型及家租戶登入需求。
對於符合資格的內部來賓,請將現有的 TAP 流程與員工通行金鑰註冊路徑分開使用。 內部或外部訪客均不支援通行金鑰(FIDO2)註冊;TAP 支援並未移除此限制,目前預覽版也未新增例外。
若為 Microsoft Graph,產生臨時存取密碼,並透過電子郵件傳送給使用者的主管工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 加入者 |
| 顯示名稱 | GenerateTAPAndSendEmail(可由使用者自訂) |
| 描述 | 產生臨時存取密碼,並透過電子郵件傳送給使用者的主管 (使用者自訂) |
| 任務定義ID | 1b555e50-7f65-41d5-b514-5894a026d10d |
| 引數 | 引數包含名稱參數 “tapLifetimeInMinutes”,這是從 startDateTime 開始的 temporaryAccessPass 的存留期 (以分鐘為單位)。 至少為 10,最多為 43200 (相當於 30 天)。 引數也包括 tapIsUsableOnce 參數,可判斷密碼是否限制為一次性使用。 如果為 true,則可以使用密碼一次;如果為 false,則可以在 temporaryAccessPass 存留期內多次使用密碼。 此外,也可以指定可選 的常見電子郵件任務參數 ;如果沒有包含在內,預設行為就會生效。 |
工作流程中的使用範例:
{
"category": "joiner",
"continueOnError": false,
"description": "Generate Temporary Access Pass and send via email to user's manager",
"displayName": "Generate TAP and Send Email",
"isEnabled": true,
"taskDefinitionId": "1b555e50-7f65-41d5-b514-5894a026d10d",
"arguments": [
{
"name": "tapLifetimeMinutes",
"value": "480"
},
{
"name": "tapIsUsableOnce",
"value": "false"
},
{
"name": "cc",
"value": "068fa0c1-fa00-4f4f-8411-e968d921c3e7,9d208c40-7eb6-46ff-bebd-f30148c39b47"
},
{
"name": "customSubject",
"value": "Temporary access pass for your new employee {{userDisplayName}}"
},
{
"name": "customBody",
"value": "Hello {{managerDisplayName}}\n\nPlease find the temporary access pass for your new employee {{userDisplayName}} below:\n\n{{temporaryAccessPass}}\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}
傳送電子郵件以向主管通知使用者移動
當使用者在組織生命週期工作流程內移動時,可讓您傳送電子郵件給使用者的管理員,通知他們移動。 您也可以自訂傳送給使用者主管的電子郵件。
要執行傳送電子郵件通知管理員使用者調動工作的 Microsoft Entra 先決條件如下:
- 已填入的使用者主管屬性。
- 已填入的使用者主管電子郵件屬性。
若為 Microsoft Graph,傳送電子郵件以向主管通知使用者移動工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 搬運工 |
| 顯示名稱 | 傳送電子郵件以向主管通知使用者移動 (使用者可自訂) |
| 描述 | 傳送電子郵件以向使用者的主管通知使用者移動 (使用者可自訂) |
| 任務定義ID | AAB41899-9972-422A-9D97-F626014578B7 |
| 引數 | 可選的 常見電子郵件任務參數 可以指定;如果沒有包含在內,預設行為就會生效。 |
工作流程中的使用範例:
{
"category": "mover",
"continueOnError": false,
"description": "Send email to notify user\u2019s manager of user move",
"displayName": "Send email to notify manager of user move",
"isEnabled": true,
"taskDefinitionId": "aab41899-9972-422a-9d97-f626014578b7",
"arguments": [
{
"name": "cc",
"value": "ac17d108-60cd-4eb2-a4b4-084cacda33f2,7d3ee937-edcc-46b0-9e2c-f832e01231ea"
},
{
"name": "customSubject",
"value": "{{userDisplayName}} has moved"
},
{
"name": "customBody",
"value": "Hello {{managerDisplayName}}\n\nwe are reaching out to let you know {{userDisplayName}} has moved in the organization.\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}
要求指派使用者存取封裝
允許您為使用者申請存取套件指派。 如果已針對存取套件設定核准程序且應該執行,您必須選擇加入 Enforce policy approval setting for admin direct assignments 權利管理設定。 如需存取套件的詳細資訊,請參閱什麼是存取套件,我可以用存取套件來管理哪些資源。
您可以自訂此工作的工作名稱和工作描述。 您也必須選取使用者所申請的存取套件和政策。
若為 Microsoft Graph,要求使用者存取套件指派工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 木匠、搬運工 |
| 顯示名稱 | 要求使用者存取套件指派 (使用者可自訂) |
| 描述 | 要求將所選取的存取套件指派給使用者 (可由使用者自訂) |
| 任務定義ID | c1ec1e76-f374-4375-aa6-0bb6bd4c60be |
| 引數 | 參數包含兩個名稱參數:「assignmentPolicyId」和「accessPackageId」。 |
工作流程中的使用範例:
{
"category": "joiner,mover",
"continueOnError": false,
"description": "Request user assignment to selected access package",
"displayName": "Request user access package assignment",
"isEnabled": true,
"taskDefinitionId": "c1ec1e76-f374-4375-aaa6-0bb6bd4c60be",
"arguments": [
{
"name": "assignmentPolicyId",
"value": "00d6fd25-6695-4f4a-8186-e4c6f901d2c1"
},
{
"name": "accessPackageId",
"value": "2ae5d6e5-6cbe-4710-82f2-09ef6ffff0d0"
}
]
}
將授權指派給使用者
允許將授權指派給使用者。 若要將授權指派給使用者,必須設定 "usageLocation" 屬性。
| 參數 | 定義 |
|---|---|
| 分類 | 木匠、搬運工 |
| 顯示名稱 | 將授權指派給使用者 (使用者可自訂) |
| 描述 | 將選取的授權指派給使用者 (使用者可自訂) |
| 任務定義ID | 683c87a4-2ad4-420b-97d4-220d90afcd24 |
| 引數 | 引數包含一個參數,其名稱為「licenses」,接受「SKU ID」值。 如需這些值的完整清單,請參閱:用於授權的產品名稱和服務方案識別碼。 |
工作流程中的使用範例:
{
"category": "joiner,mover",
"continueOnError": false,
"description": "Assign selected licenses to the user",
"displayName": "Assign licenses to user",
"isEnabled": true,
"taskDefinitionId": "683c87a4-2ad4-420b-97d4-220d90afcd24",
"arguments": [
{
"name": "licenses",
"value": "a403ebcc-fae0-4ca2-8c8c-7a907fd6c235"
}
]
}
將使用者新增至群組
允許使用者新增至 Microsoft 365 和僅限雲端的安全性群組。 不支援具備郵件功能的群組、通訊群組、動態群組以及可以指派角色的群組。 若要控制以內部部署 AD 群組為基礎的應用程式和資源存取權,您必須啟用群組回寫。 如需詳細資訊,請參閱 Microsoft Entra 雲端同步群組回寫 和 使用群組回寫與權限管理。
您可以自訂此工作的工作名稱和描述。
若為 Microsoft Graph,將使用者新增至群組工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 加入者、離開者 |
| 顯示名稱 | AddUserToGroup (使用者自訂) |
| 描述 | 將使用者新增至群組 (使用者自訂) |
| 任務定義ID | 22085229-5809-45e8-97fd-270d28d66910 |
| 引數 | 引數包含 「groupID」 的名稱參數,以及值參數,即您要在該群組中新增使用者的群組識別碼。 |
工作流程中的使用範例:
{
"category": "joiner,leaver",
"description": "Add user to groups",
"displayName": "AddUserToGroup",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "22085229-5809-45e8-97fd-270d28d66910",
"arguments": [
{
"name": "groupID",
"value": "0732f92d-6eb5-4560-80a4-4bf242a7d501"
}
]
}
將使用者新增至小組
您可以將使用者新增至現有的靜態小組。 您可以自訂此工作的工作名稱和描述。
若為 Microsoft Graph,將使用者新增至小組工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 加入者、離開者 |
| 顯示名稱 | AddUserToTeam (使用者自訂) |
| 描述 | 將使用者新增至小組 (使用者自訂) |
| 任務定義ID | E440ED8D-25A1-4618-84CE-091ED5BE5594 |
| 引數 | 引數包含名稱參數,即「teamID」,以及值參數,即您要新增使用者之現有小組的小組識別碼。 |
工作流程中的使用範例:
{
"category": "joiner,leaver",
"description": "Add user to team",
"displayName": "AddUserToTeam",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "e440ed8d-25a1-4618-84ce-091ed5be5594",
"arguments": [
{
"name": "teamID",
"value": "e3cc382a-c4b6-4a8c-b26d-a9a3855421bd"
}
]
}
更新使用者屬性
生命週期工作流程允許你自動化更新組織中使用者屬性。 您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
注意
對於從本地 AD 同步的使用者,此任務僅支援目錄擴充屬性。 欲了解更多資訊,請參閱: 使用生命週期工作流程更新使用者屬性。
對於 Microsoft Graph,Update 使用者屬性任務的參數如下:
| 參數 | 定義 |
|---|---|
| 分類 | 新加入者、離職者、調動者 |
| 顯示名稱 | 更新使用者屬性 |
| 描述 | 更新或清除使用者屬性值。 |
| 任務定義ID | 2c8f4a1b-7d3e-4f9c-8a5b-6e1d2c3f4a5b |
| 引數 | 參數包含名稱參數「attributeUpdates」,這是一個 JSON 字串,指定最多 10 個使用者屬性需更新或清除。 屬性可以包含內建的本地擴充功能、目錄擴充功能以及員工組織資料。 |
工作流程中的使用範例:
{
"category": "joiner",
"continueOnError": false,
"description": "Update or clear user attribute values including custom attributes",
"displayName": "Update user attributes",
"isEnabled": true,
"taskDefinitionId": "2c8f4a1b-7d3e-4f9c-8a5b-6e1d2c3f4a5b",
"arguments": [
{
"name": "attributeUpdates",
"value": "[{\"attribute\":\"department\",\"value\":\"Sales\"},{\"attribute\":\"jobTitle\",\"value\":\"Account Executive\"}]"
}
]
}
啟用使用者帳戶
允許啟用使用者帳戶。 如需了解針對已同步的內部用戶執行此工作的必要條件,請參閱:用戶帳戶工作。 不支援具有 Microsoft Entra 角色指派的使用者,也不支援具有可指派角色群組成員資格或擁有權的使用者。 您也可以利用 Microsoft Entra ID 的 HR 驅動佈建功能,將資料佈建至內部部署 Active Directory,並根據 HR 來源的資料,使用屬性對應至 accountDisabled,來停用或啟用已同步的帳戶。 如需詳細資訊,請參閱:Workday 設定屬性對應和 SuccessFactors 設定屬性對應。 您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
若為 Microsoft Graph,啟用使用者帳戶工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 加入者、離開者 |
| 顯示名稱 | EnableUserAccount (使用者自訂) |
| 描述 | 啟用使用者帳戶 (使用者自訂) |
| 任務定義ID | 6fc52c9d-398b-4305-9763-15f42c1676fc |
| 引數 | 可包含選擇性 enableOnPremisesAccount 引數。 此值為布林值,如果您想讓同步的內部部署使用者執行此工作,則為 true;如果您不想讓同步的內部部署使用者執行此工作,則為 false。 |
工作流程中的使用範例:
{
"category": "joiner,leaver",
"description": "Enable user account",
"displayName": "EnableUserAccount",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "6fc52c9d-398b-4305-9763-15f42c1676fc",
"arguments": [
{
"name": "enableOnPremisesAccount",
"value": "true"
}
]
}
執行自訂工作延伸模組
工作流程可以設定為啟動自訂工作延伸模組。 您可以使用 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
Microsoft Entra 的必要條件如下,以執行執行自訂工作延伸模組任務:
- 與自訂工作延伸模組相容的邏輯應用程式。 如需詳細資訊,請參閱:生命週期工作流程擴充性。
若為 Microsoft Graph,執行自訂工作延伸模組工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 加入者、離開者 |
| 顯示名稱 | 執行自訂工作延伸模組 (使用者自訂) |
| 描述 | 執行自訂工作延伸模組以呼叫外部系統。 (使用者可自訂) |
| 任務定義ID | D79D1FCC-16BE-490C-A865-F4533B1639EE |
| 引數 | 引數包含名稱參數,即「customTaskExtensionID」,以及值參數,該參數是先前建立的延伸模組識別碼,其中包含邏輯應用程式的相關資訊。 |
工作流程中的使用範例:
{
"category": "joiner,leaver",
"description": "Run a Custom Task Extension to call-out to an external system.",
"displayName": "Run a Custom Task Extension",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "d79d1fcc-16be-490c-a865-f4533b1639ee",
"arguments": [
{
"name": "customTaskExtensionID",
"value": "<ID of your Custom Task Extension>"
}
]
}
如需設定 Logic 應用程式以搭配生命週期工作流程執行的詳細資訊,請參閱:透過自訂的生命週期工作流程任務觸發 Logic Apps。
停用使用者帳戶
允許停用使用者帳戶。 如需了解針對已同步的內部用戶執行此工作的必要條件,請參閱:用戶帳戶工作。 不支援具有 Microsoft Entra 角色指派的使用者,也不支援具有可指派角色群組成員資格或擁有權的使用者。 您可以利用 Microsoft Entra ID 的 HR 驅動式佈建功能,根據來自 HR 來源的資料,將屬性對應至 accountDisabled,然後在內部部署 Active Directory 中停用和啟用已同步的帳戶。 如需詳細資訊,請參閱:Workday 設定屬性對應和 SuccessFactors 設定屬性對應。 您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
若為 Microsoft Graph,停用使用者帳戶工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 加入者、離開者 |
| 顯示名稱 | DisableUserAccount (使用者自訂) |
| 描述 | 停用使用者帳戶 (使用者自訂) |
| 任務定義ID | 1dfdfcc7-52fa-4c2e-bf3a-e3919cc12950 |
| 引數 | 可包含選擇性 disableOnPremisesAccount 引數。 此值為布林值,如果您想讓同步的內部部署使用者執行此工作,則為 true;如果您不想讓同步的內部部署使用者執行此工作,則為 false。 |
工作流程中的使用範例:
{
"category": "joiner,leaver",
"description": "Disable user account",
"displayName": "DisableUserAccount",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "1dfdfcc7-52fa-4c2e-bf3a-e3919cc12950",
"arguments": [
{
"name": "disableOnPremisesAccount",
"value": "true"
}
]
}
從選取的群組中移除使用者
允許使用者從 Microsoft 365 和僅限雲端的安全性群組中移除。 不支援具備郵件功能的群組、通訊群組、動態群組以及可以指派角色的群組。 若要控制以內部部署 AD 群組為基礎的應用程式和資源存取權,您必須啟用群組回寫。 如需詳細資訊,請參閱 Microsoft Entra 雲端同步群組回寫 和 使用群組回寫與權限管理。
您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
若為 Microsoft Graph,從選取的群組中移除使用者工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者 |
| 顯示名稱 | 從選取的群組中移除使用者 (使用者自訂) |
| 描述 | 從選取的 Microsoft Entra 群組成員資格中移除使用者 (使用者可自訂) |
| 任務定義ID | 1953A66C-751C-45E5-8BFE-01462C70DA3C |
| 引數 | 引數包含名稱參數,即「groupID」,以及值參數,即您要從中移除使用者的群組或群組的群組識別碼。 |
工作流程中的使用範例:
{
"category": "leaver",
"displayName": "Remove user from selected groups",
"description": "Remove user from membership of selected Azure AD groups",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "1953a66c-751c-45e5-8bfe-01462c70da3c",
"arguments": [
{
"name": "groupID",
"value": "GroupId1, GroupId2, GroupId3, ..."
}
]
}
從所有群組中移除使用者
允許使用者從其所屬的每個 Microsoft 365 和僅限雲端環境的安全性群組中被移除。 不支援具備郵件功能的群組、通訊群組、動態群組以及可以指派角色的群組。 若要控制以內部部署 AD 群組為基礎的應用程式和資源存取權,您必須啟用群組回寫。 如需詳細資訊,請參閱 Microsoft Entra 雲端同步群組回寫。
您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
若為 Microsoft Graph,從所有群組中移除使用者工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者 |
| 顯示名稱 | 從所有群組中移除使用者 (使用者自訂) |
| 描述 | 從所有 Microsoft Entra 群組成員資格中移除使用者 (使用者可自訂) |
| 任務定義ID | B3A31406-2A15-4C9A-B25B-A658FA5F07FC |
工作流程中的使用範例:
{
"category": "leaver",
"continueOnError": true,
"displayName": "Remove user from all groups",
"description": "Remove user from all Azure AD groups memberships",
"isEnabled": true,
"taskDefinitionId": "b3a31406-2a15-4c9a-b25b-a658fa5f07fc",
"arguments": []
}
從選取的 Teams 中移除使用者
允許使用者從單一或多個靜態小組中移除。 您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
若為 Microsoft Graph,從小組中移除使用者工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 加入者、離開者 |
| 顯示名稱 | 從選取的小組中移除使用者 (使用者自訂) |
| 描述 | 從選取的小組成員資格中移除使用者 (使用者自訂) |
| 任務定義ID | 06aa7acb-01af-4824-8899-b14e5ed788d6 |
| 引數 | 引數包含 「teamID」 的名稱參數,以及值參數,即您要從該小組中移除使用者的小組識別碼。 |
工作流程中的使用範例:
{
"category": "joiner,leaver",
"continueOnError": true,
"displayName": "Remove user from selected Teams",
"description": "Remove user from membership of selected Teams",
"isEnabled": true,
"taskDefinitionId": "06aa7acb-01af-4824-8899-b14e5ed788d6",
"arguments": [
{
"name": "teamID",
"value": "TeamId1, TeamId2, TeamId3, ..."
}
]
}
從所有小組中移除使用者
允許從使用者所屬的每個靜態小組中移除使用者。 您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
若為 Microsoft Graph,從所有小組中移除使用者工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者 |
| 顯示名稱 | 從所有小組成員資格中移除使用者 (使用者自訂) |
| 描述 | 從所有小組中移除使用者 (使用者自訂) |
| 任務定義ID | 81f7b200-2816-4b3b-8c5d-dc556f07b024 |
工作流程中的使用範例:
{
"category": "leaver",
"continueOnError": true,
"description": "Remove user from all Teams",
"displayName": "Remove user from all Teams memberships",
"isEnabled": true,
"taskDefinitionId": "81f7b200-2816-4b3b-8c5d-dc556f07b024",
"arguments": []
}
移除使用者的存取套組指派
允許您移除使用者的存取套件分配。 如需存取套件的詳細資訊,請參閱什麼是存取套件,我可以用存取套件來管理哪些資源。
您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。 您也需要選擇想要移除指派的存取套件。
若為 Microsoft Graph,移除使用者的存取套件指派工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者、移動者 |
| 顯示名稱 | 移除使用者的存取套件指派 (使用者可自訂) |
| 描述 | 移除所選存取套件的使用者指派 (使用者可自訂) |
| 任務定義ID | 4a0b64f2-c7ec-46ba-b117-18f262946c50 |
| 引數 | 引數包含一個名稱參數 "accessPackageId"。 |
工作流程中的使用範例:
{
"category": "leaver, mover",
"continueOnError": false,
"description": "Remove user assignment of selected access package",
"displayName": "Remove access package assignment for user",
"isEnabled": true,
"taskDefinitionId": "4a0b64f2-c7ec-46ba-b117-18f262946c50",
"arguments": [
{
"name": "accessPackageId",
"value": "2ae5d6e5-6cbe-4710-82f2-09ef6ffff0d0"
}
]
}
移除所有使用者的存取套件指派
允許您移除使用者的所有存取套件指派。 如需存取套件的詳細資訊,請參閱什麼是存取套件,我可以用存取套件來管理哪些資源。
你可以在 Microsoft Entra 管理中心自訂任務名稱、描述,以及存取套件指派是立即移除還是在特定天數後移除。 在搬運工作流程範本中使用時,預設選項是排程移除,設定為 15 天。
若為 Microsoft Graph,移除使用者的所有存取套件指派工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者、移動者 |
| 顯示名稱 | 移除使用者的所有存取套件指派 (使用者可自訂) |
| 描述 | 移除該使用者的所有存取套件指派。 當 daysUntil Expiration 被設定時,移除會被排定,而非立即移除。 (使用者可自訂) |
| 任務定義ID | 42ae2956-193d-4f39-be06-691b8ac4fa1d |
| 引數 | 參數包含一個必填的名稱參數,即「daysUntilExpiration」,以及一個值參數,表示使用者所有存取套件指派到期前的天數。 對於搬家模板,預設為15天。 |
工作流程中的使用範例:
{
"category": "leaver",
"continueOnError": false,
"description": "Remove all access package assignments for the user. When daysUntilExpiration is set, removal is scheduled rather than immediate.",
"displayName": "Remove all access package assignments for user",
"isEnabled": true,
"taskDefinitionId": "42ae2956-193d-4f39-be06-691b8ac4fa1d",
"arguments": [
{
"description": "Remove all access package assignments for the user. When daysUntilExpiration is set, removal is scheduled rather than immediate.",
"displayName": "Remove all access package assignments for user",
"id": "42ae2956-193d-4f39-be06-691b8ac4fa1d",
"version": 1,
"parameters": [
{
"name": "daysUntilExpiration",
"values": [],
"valueType": "string"
}
]
}
]
取消使用者所有待處理的存取套件指派要求
允許您取消使用者所有擱置的存取套件指派要求。 如需存取套件的詳細資訊,請參閱什麼是存取套件,我可以用存取套件來管理哪些資源。
您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
若為 Microsoft Graph,取消使用者所有擱置的存取套件指派要求工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者 |
| 顯示名稱 | 取消使用者擱置的存取套件指派要求 (使用者可自訂) |
| 描述 | 取消使用者所有擱置的存取套件指派要求 (使用者可自訂) |
| 任務定義ID | 498770d9-bab7-4e4c-b73d-5ded82a1d0b3 |
工作流程中的使用範例:
{
"category": "leaver",
"continueOnError": false,
"description": "Cancel all access package assignment requests pending for the user",
"displayName": "Cancel all pending access package assignment requests for user",
"isEnabled": true,
"taskDefinitionId": "498770d9-bab7-4e4c-b73d-5ded82a1d0b3",
"arguments": []
}
從使用者中移除選取的授權指派
移除使用者的特定授權指派。
您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
在 Microsoft Graph 中,執行移除使用者的選取授權指派工作的參數如下:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者、移動者 |
| 顯示名稱 | 移除使用者的授權 (使用者可自訂) |
| 描述 | 移除指派給使用者的選取授權 (使用者可自訂) |
| 任務定義ID | 5fc402a8-daaf-4b7b-9203-da868b05fc5f |
| 引數 | 引數包含一個參數,其名稱為「licenses」,接受「SKU ID」值。 如需這些值的完整清單,請參閱:用於授權的產品名稱和服務方案識別碼。 |
工作流程中的使用範例:
{
"category": "leaver, mover",
"description": "Remove selected licenses assigned to the user",
"displayName": "Remove licenses from user",
"id": "5fc402a8-daaf-4b7b-9203-da868b05fc5f",
"version": 1,
"parameters": [
{
"name": "licenses",
"values": [],
"valueType": "string"
}
]
}
撤銷使用者的所有刷新令牌
允許撤銷使用者的所有刷新令牌和瀏覽器會話令牌。 這會使為使用者頒發給應用程式的所有刷新令牌和瀏覽器會話令牌失效,但外部使用者登錄會話除外,因為外部使用者通過其主租戶登錄。
您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
對於 Microsoft Graph, 撤銷使用者的所有刷新令牌 任務的參數如下:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者、移動者 |
| 顯示名稱 | 撤銷使用者的所有刷新令牌 |
| 描述 | 撤銷使用者的所有刷新令牌 |
| 任務定義ID | 509589a4-0466-4471-829e-49c5e502bdee |
工作流程中的使用範例:
{
"category": "leaver, mover",
"continueOnError": false,
"description": "Revoke all refresh tokens for user",
"displayName": "Revoke all refresh tokens for user",
"isEnabled": true,
"taskDefinitionId": "509589a4-0466-4471-829e-49c5e502bdee",
"arguments": []
}
寄信給經理,詢問贊助變動
允許將電子郵件寄給已搬遷或離職員工的經理。 這封電子郵件通知經理,該員工已搬遷或離職,曾是一個或多個代理人ID的贊助人。 這讓經理可以決定代理人ID是否應該有不同的員工作為擔保人。
您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
對於 Microsoft Graph,發送 郵件給經理關於贊助變更 的任務參數如下:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者、移動者 |
| 顯示名稱 | 寄信給經理,詢問贊助變動 |
| 描述 | 通知擔保人的經理關於代理人身份擔保轉移的事宜。 |
| 任務定義ID | b8c4e1f9-3a7d-4b2e-9c5f-8d6a9b1c2e3f |
| 引數 | 可選的 常見電子郵件任務參數 可以指定;如果沒有包含在內,預設行為就會生效。 |
工作流程中的使用範例:
{
"category": "mover",
"continueOnError": false,
"description": "Notify sponsor's manager about agent identity sponsorship transfer.",
"displayName": "Send email to manager about sponsorship transfer",
"isEnabled": true,
"taskDefinitionId": "b8c4e1f9-3a7d-4b2e-9c5f-8d6a9b1c2e3f ",
"arguments": [
{
"name": "cc",
"value": "ac17d108-60cd-4eb2-a4b4-084cacda33f2,7d3ee937-edcc-46b0-9e2c-f832e01231ea"
},
{
"name": "customSubject",
"value": "{{userDisplayName}} has moved"
},
{
"name": "customBody",
"value": "Hello {{managerDisplayName}}\n\nwe are reaching out to let you know {{userDisplayName}} has moved in the organization and you have taken over their agent ID sponsorships.\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}
請寄電子郵件給共同贊助人,詢問贊助人變動
允許在某位同時也是代理人ID贊助人的用戶搬遷或離開時,向代理人ID的共同贊助人發送電子郵件。 此通知共同擔保人有關代理人ID擔保變更的信息。
您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
對於 Microsoft Graph,發送 有關贊助商變更的電子郵件給共同贊助商的 任務參數如下:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者、移動者 |
| 顯示名稱 | 請寄電子郵件給共同贊助人,詢問贊助人變動 |
| 描述 | 通知共同擔保人有關代理人身份角色擔保的變更。 |
| 任務定義ID | AD3B85CD-75B1-43E7-B4B9-0E52FABA3944 |
工作流程中的使用範例:
{
"category": "mover",
"continueOnError": false,
"description": "Notify co-sponsors about agent identity sponsorship changes.",
"displayName": "Send email to co-sponsors about sponsor changes",
"isEnabled": true,
"taskDefinitionId": "ad3b85cd-75b1-43e7-b4b9-0e52faba3944",
"arguments": [
{
"name": "cc",
"value": "ac17d108-60cd-4eb2-a4b4-084cacda33f2,7d3ee937-edcc-46b0-9e2c-f832e01231ea"
},
{
"name": "customSubject",
"value": "{{userDisplayName}} has moved"
},
{
"name": "customBody",
"value": "Hello \n\nwe are reaching out to let you know {{userDisplayName}} has moved in the organization and will no longer have sponsorship authority over agent IDs they previously sponsored with you.\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}
將代理人身份贊助轉移給經理
允許所有代理人身份贊助權從使用者轉移給其經理。 透過取得使用者的管理員、識別他們所贊助的每個代理身份,將管理員加入為贊助者,並移除使用者作為贊助者來完成任務。
您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
執行「將代理程式身份贊助轉移至管理者」任務的 Microsoft Entra 先決條件為:
- 已填入的使用者主管屬性。
對於 Microsoft Graph,「將代理身份贊助轉移至管理者」任務的參數如下:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者、移動者 |
| 顯示名稱 | 將代理人身份贊助轉移給經理 |
| 描述 | 將使用者贊助的所有代理身份轉移給管理員。 |
| 任務定義ID | B8F4C3D5-9E7A-4B1C-8F2D-6A5E8B9C7F4A |
{
"category": "mover",
"continueOnError": false,
"description": "Transfer all agent identities sponsored by user to manager.",
"displayName": "Transfer agent identity sponsorships to manager",
"isEnabled": true,
"taskDefinitionId": "b8f4c3d5-9e7a-4b1c-8f2d-6a5e8b9c7f4a",
"arguments": []
}
移除使用者的所有授權指派
允許移除使用者所有的直接授權指派。 針對群組型授權指派,請執行從授權指派所屬的群組中移除使用者的工作。
您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
若為 Microsoft Graph,移除使用者的所有授權指派工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者 |
| 顯示名稱 | 移除使用者的所有授權 (使用者自訂) |
| 描述 | 移除指派給使用者的所有授權 (使用者自訂) |
| 任務定義ID | 8FA97D28-3E52-4985-B3A9-A1126F9B8B4E |
工作流程中的使用範例:
{
"category": "leaver",
"continueOnError": true,
"displayName": "Remove all licenses for user",
"description": "Remove all licenses assigned to the user",
"isEnabled": true,
"taskDefinitionId": "8fa97d28-3e52-4985-b3a9-a1126f9b8b4e",
"arguments": []
}
刪除使用者
允許刪除使用者帳戶。 如需了解針對已同步的內部用戶執行此工作的必要條件,請參閱:用戶帳戶工作。 不支援具有 Microsoft Entra 角色指派的使用者,也不支援具有可指派角色群組成員資格或擁有權的使用者。 您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
若為 Microsoft Graph,刪除使用者工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者 |
| 顯示名稱 | 刪除使用者帳戶 (使用者自訂) |
| 描述 | 刪除 Microsoft Entra ID 中的使用者帳戶 (使用者可自訂) |
| 任務定義ID | 8d18588d-9ad3-4c0f-99d0-ec215f0e3dff |
| 引數 | 可包含選擇性 deleteOnPremisesAccount 引數。 此值為布林值,如果您想讓同步的內部部署使用者執行此工作,則為 true;如果您不想讓內部部署使用者執行此工作,則為 false。 |
工作流程中的使用範例:
{
"category": "leaver",
"continueOnError": true,
"displayName": "Delete user account",
"description": "Delete user account in Azure AD",
"isEnabled": true,
"taskDefinitionId": "8d18588d-9ad3-4c0f-99d0-ec215f0e3dff",
"arguments": [
{
"name": "deleteOnPremisesAccount",
"value": "true"
}
]
}
在使用者的離職日期之前傳送電子郵件給主管
允許在使用者離職日期之前傳送電子郵件給使用者的主管。 您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
執行「在使用者最後一天前傳送電子郵件」任務的 Microsoft Entra 必要條件如下:
- 已填入的使用者主管屬性。
- 已填入的使用者主管電子郵件屬性。
若為 Microsoft Graph,在使用者離職日期之前傳送電子郵件工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者 |
| 顯示名稱 | 在使用者的離職日期之前傳送電子郵件 (使用者自訂) |
| 描述 | 在離職日期之前傳送離職電子郵件給使用者的主管 (使用者自訂) |
| 任務定義ID | 52853a3e-f4e5-4eb8-bb24-1ac09a1da935 |
| 引數 | 可選的 常見電子郵件任務參數 可以指定;如果沒有包含在內,預設行為就會生效。 |
工作流程中的使用範例:
{
"category": "leaver",
"continueOnError": false,
"description": "Send offboarding email to user’s manager before the last day of work",
"displayName": "Send email before user’s last day",
"isEnabled": true,
"taskDefinitionId": "52853a3e-f4e5-4eb8-bb24-1ac09a1da935",
"arguments": [
{
"name": "cc",
"value": "068fa0c1-fa00-4f4f-8411-e968d921c3e7,e94ad2cd-d590-4b39-8e46-bb4f8e293f85"
},
{
"name": "customSubject",
"value": "Reminder that {{userDisplayName}}'s last day is coming up"
},
{
"name": "customBody",
"value": "Hello {{managerDisplayName}}\n\nthis is a reminder that {{userDisplayName}}'s last day is coming up.\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}
在使用者離職當天寄送郵件
允許在使用者離職當日傳送電子郵件給使用者的主管。 您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
執行 Microsoft Entra 在使用者最後一天傳送電子郵件任務的必要條件如下:
- 已填入的使用者主管屬性。
- 已填入的使用者主管電子郵件屬性。
若為 Microsoft Graph,在使用者離職當日傳送電子郵件工作的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者 |
| 顯示名稱 | 在使用者的離職日期傳送電子郵件 (使用者自訂) |
| 描述 | 在離職當日傳送離職電子郵件給使用者的主管 (使用者自訂) |
| 任務定義ID | 9c0a1eaf-5bda-4392-9d9e-6e155bb57411 |
| 引數 | 可選的 常見電子郵件任務參數 可以指定;如果沒有包含在內,預設行為就會生效。 |
工作流程中的使用範例:
{
"category": "leaver",
"continueOnError": false,
"description": "Send offboarding email to user’s manager on the last day of work",
"displayName": "Send email on user’s last day",
"isEnabled": true,
"taskDefinitionId": "9c0a1eaf-5bda-4392-9d9e-6e155bb57411",
"arguments": [
{
"name": "cc",
"value": "068fa0c1-fa00-4f4f-8411-e968d921c3e7,e94ad2cd-d590-4b39-8e46-bb4f8e293f85"
},
{
"name": "customSubject",
"value": "{{userDisplayName}}'s last day"
},
{
"name": "customBody",
"value": "Hello {{managerDisplayName}}\n\nthis is a reminder that {{userDisplayName}}'s last day is today and their access will be revoked.\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}
在使用者的最後工作日之後發送電子郵件給其主管
允許在使用者的最後工作日後,傳送包含離職資訊的電子郵件給使用者的主管。 您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
Microsoft Entra 執行在使用者的最後一天後傳送電子郵件給使用者的主管任務所需的先決條件:
- 已填入的使用者主管屬性。
- 已填入的使用者主管電子郵件屬性。
針對 Microsoft Graph,「在用戶最後一天之後傳送電子郵件給使用者管理員」這項任務的參數如下所示:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者 |
| 顯示名稱 | 在使用者的最後工作日之後發送電子郵件給其主管 |
| 描述 | 在工作最後一天之後,傳送電子郵件給使用者的主管,內容為離職通知(可由使用者自訂) |
| 任務定義ID | 6f22ddd4-b3a5-47a4-a846-0d7c201a49ce |
| 引數 | 可選的 常見電子郵件任務參數 可以指定;如果沒有包含在內,預設行為就會生效。 |
工作流程中的使用範例:
{
"category": "leaver",
"continueOnError": false,
"description": "Send offboarding email to user’s manager after the last day of work",
"displayName": "Send email after user’s last day",
"isEnabled": true,
"taskDefinitionId": "6f22ddd4-b3a5-47a4-a846-0d7c201a49ce",
"arguments": [
{
"name": "cc",
"value": "ac17d108-60cd-4eb2-a4b4-084cacda33f2,7d3ee937-edcc-46b0-9e2c-f832e01231ea"
},
{
"name": "customSubject",
"value": "{{userDisplayName}}'s accounts will be deleted today"
},
{
"name": "customBody",
"value": "Hello {{managerDisplayName}}\n\nthis is a reminder that {{userDisplayName}} left the organization a while ago and today their disabled accounts will be deleted.\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}
發送關於使用者不活躍的電子郵件
允許在使用者上次登入後過了指定天數後,將關於非作用中使用者資訊的電子郵件傳送給使用者的管理員。 您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
執行「 發送關於使用者不活躍郵件 」任務的 Microsoft Entra 先決條件如下:
- 已填入的使用者主管屬性。
- 已填入的使用者主管電子郵件屬性。
對於 Microsoft Graph,發送 關於使用者不活躍郵件 的任務參數如下:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者 |
| 顯示名稱 | 發送關於使用者不活躍的電子郵件 |
| 描述 | 通知管理員使用者已處於非活動狀態(可由使用者自訂) |
| 任務定義ID | 92f74cb4-f1b6-4ec0-b766-96210f56edc2 |
| 引數 | 可選的 常見電子郵件任務參數 可以指定;如果沒有包含在內,預設行為就會生效。 |
工作流程中的使用範例:
{
"category": "leaver",
"continueOnError": false,
"description": " Notify manager that user has been inactive",
"displayName": "Send email about user inactivity",
"isEnabled": true,
"taskDefinitionId": "92f74cb4-f1b6-4ec0-b766-96210f56edc2",
"arguments": [
{
"name": "cc",
"value": "1bda0458-cb4b-473d-baf5-61125c86a6d3,7f552c25-e0f6-40b6-b4e0-36bb40ba7fb6"
},
{
"name": "customSubject",
"value": "[UserDisplayName]’s account has been inactive for [NumberofDays] days."
},
{
"name": "customBody",
"value": "We’re notifying you that a recent sign-in for [UserDisplayName]’s user account has not been detected, and the account is considered inactive. The last sign in was [LastSigninDate]. To maintain a secure environment, your organization may have already started the process to disable or delete this user account.\n\nPlease check your organization’s policies and take appropriate action if this user account is still needed.\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}
發送關於非贊助賓客移除的電子郵件(預覽)
當非贊助賓客被移除出組織時,允許你向指定收件人發送電子郵件通知。 此任務是偵測及清理 Microsoft Entra ID 中無贊助賓客的自動化工具之一。 您可以在 Microsoft Entra 系統管理中心自訂此工作的工作名稱和描述。
注意
此任務目前仍處於預覽階段,僅適用於離職流程。
執行 Microsoft Entra 的傳送有關移除未受贊助來賓的電子郵件 (預覽)工作所需的先決條件如下:
- 訪客用戶帳號必須被識別為無贊助(無有效贊助者)。
在 Microsoft Graph 中,傳送關於移除未受贊助來賓的電子郵件(預覽)工作的參數如下:
| 參數 | 定義 |
|---|---|
| 分類 | 離開者 |
| 顯示名稱 | 發送關於非贊助賓客移除的電子郵件(預覽) |
| 描述 | 通知指定收件人有關移除非贊助賓客的通知(可由使用者自訂) |
| 任務定義ID | a8e4c7f2-9d1b-4a3e-b5c6-8f2e7a9d4c1b |
| 引數 | 可選的 常見電子郵件任務參數 可以指定;如果沒有包含在內,預設行為就會生效。 接收者可包括生命週期工作流管理員、全域管理員、選定使用者、管理者或使用者。 |
工作流程中的使用範例:
{
"category": "leaver",
"continueOnError": false,
"description": "Notify specified recipients about unsponsored guest removal",
"displayName": "Send email about unsponsored guest removal (Preview)",
"isEnabled": true,
"taskDefinitionId": "a8e4c7f2-9d1b-4a3e-b5c6-8f2e7a9d4c1b",
"arguments": [
{
"name": "cc",
"value": "ac17d108-60cd-4eb2-a4b4-084cacda33f2"
},
{
"name": "customSubject",
"value": "Guest user {{userDisplayName}} removal notification"
},
{
"name": "customBody",
"value": "Hello,\n\nThis is a notification that guest user {{userDisplayName}} is being removed from your organization due to no valid sponsor.\n\nIf you believe this action is incorrect, please contact your IT department immediately.\n\nRegards\nYour IT department"
},
{
"name": "locale",
"value": "en-us"
}
]
}