借助 Microsoft Graph Lifecycle Workflows API,可以在加入者、离开者和离开者级别自动执行用户生命周期过程。
工作流的核心是代表触发工作流时自动运行的特定操作的 任务 。 内置任务 可用于支持创建自定义工作流。 这些任务在任务定义的 参数 属性上配置。
本文介绍如何为内置任务配置参数属性以简化自动化。
为任务配置参数
| 任务显示名称 | taskDefinitionId | 参数 |
|---|---|---|
| 向新员工发送欢迎电子邮件 | 70b29d51-b59a-4773-9280-8841dfd3f2ea |
名称: ccvalue:要在电子邮件中抄送的用户的有效用户 ID (字符串) 。 名称: customSubjectvalue:正在发送的电子邮件的自定义主题标头。 名称: customBodyvalue:自定义电子邮件的正文。 名称: localevalue:覆盖电子邮件收件人语言设置的语言值。 此参数不自定义电子邮件的自定义文本,应使用与自定义文本相同的语言设置。 名称: to值: User、、 ManagersSponsors或特定userID字符串。 如果被选中,则 Sponsors 无法在参数中 cc 添加其他用户。 |
| 发送载入提醒电子邮件 | 3C860712-2D37-42A4-928F-5C93935D26A1 |
名称: ccvalue:要在电子邮件中抄送的用户的有效用户 ID (字符串) 。 名称: customSubjectvalue:正在发送的电子邮件的自定义主题标头。 名称: customBodyvalue:自定义电子邮件的正文。 名称: localevalue:覆盖电子邮件收件人语言设置的语言值。 此参数不自定义电子邮件的自定义文本,应使用与自定义文本相同的语言设置。 名称: to值: User、、 ManagersSponsors或特定userID字符串。 如果被选中,则 Sponsors 无法在参数中 cc 添加其他用户。 |
| 生成临时访问通行证并通过电子邮件发送给用户的经理 | 1b555e50-7f65-41d5-b514-5894a026d10d |
名称: tapLifetimeMinutes值: 10 最多 43000名称: tapIsUsableOncevalue: true 或 false名称: to值: User、、 ManagersSponsors或特定userID字符串。 如果被选中,则 Sponsors 无法在参数中 cc 添加其他用户。先决条件:
|
| 选择身份验证配置文件 (预览版) | 9ed82537-8442-467a-8eef-9351fb7a1f9c | 仅适用于 /beta.
verifiedIdProfileId 是必需的。 有关可选参数和收件人默认值,请参阅 配置身份验证载入任务 (beta) 。 |
| 在预览) (为演示文稿选择验证验证 ID | 8314685b-de26-4c90-b086-bfa0e7a263f3 | 仅适用于 /beta.
verifiedIdProfileId 是必需的。 有关可选参数和收件人默认值,请参阅 配置身份验证载入任务 (beta) 。 |
| 发送管理员验证状态电子邮件 (预览) | c7a1f3e5-4b2d-4e8a-9f6c-3d5a7b1e2c4f | 仅适用于 /beta.
verifiedIdProfileId 是必需的。 有关可选参数和收件人默认值,请参阅 配置身份验证载入任务 (beta) 。 |
| 将用户添加到组 | 22085229-5809-45e8-97fd-270d28d66910 |
名称: groupIDvalue:有效的组 ID 或以逗号分隔的用户作为成员添加到的组列表。 例如, "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"。 |
| 将用户添加到团队 | e440ed8d-25a1-4618-84ce-091ed5be5594 |
名称: teamIDvalue:用户作为成员添加到的有效组 ID 或以逗号分隔的团队列表。 例如, "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"。 |
| 更新用户属性 (预览) | 2c8f4a1b-7d3e-4f9c-8a5b-6e1d2c3f4a5b |
名称: attributeUpdatesvalue:一个 JSON 字符串,指定最多 10 个要更新或清除的用户属性。 这些属性可以包括内置、本地扩展、目录扩展和员工组织数据。 |
| 启用用户帐户 | 6fc52c9d-398b-4305-9763-15f42c1676fc |
名称: enableOnPremisesAccountvalue:指示任务是否启用同步本地用户帐户的布尔值。 |
| 运行自定义任务扩展 | 4262b724-8dba-4fad-afc3-43fcbb497a0e |
名称: CustomTaskExtensionIDvalue:自定义任务扩展的 ID。 |
| 向用户分配许可证 (预览) | 683c87a4-2ad4-420b-97d4-220d90afcd24 |
名称: licensesvalue:要分配的许可证的 ID。 |
| 从用户中删除选定的许可证分配 (预览) | 5fc402a8-daaf-4b7b-9203-da868b05fc5f |
名称: licensesvalue:要分配的许可证的 ID。 |
| 撤销用户的所有刷新令牌 | 509589a4-0466-4471-829e-49c5e502bdee | 无。 |
| 向经理发送有关赞助更改的电子邮件 | b8c4e1f9-3a7d-4b2e-9c5f-8d6a9b1c2e3f |
名称: ccvalue:要在电子邮件中抄送的用户的有效用户 ID (字符串) 。 名称: customSubjectvalue:正在发送的电子邮件的自定义主题标头。 名称: customBodyvalue:自定义电子邮件的正文。 名称: localevalue:覆盖电子邮件收件人语言设置的语言值。 此参数不自定义电子邮件的自定义文本,应使用与自定义文本相同的语言设置。 名称: to值: User、、 ManagersSponsors或特定userID字符串。 如果被选中,则 Sponsors 无法在参数中 cc 添加其他用户。 |
| 向共同发起人发送有关发起人更改的电子邮件 | ad3b85cd-75b1-43e7-b4b9-0e52faba3944 |
名称: ccvalue:要在电子邮件中抄送的用户的有效用户 ID (字符串) 。 名称: customSubjectvalue:正在发送的电子邮件的自定义主题标头。 名称: customBodyvalue:自定义电子邮件的正文。 名称: localevalue:覆盖电子邮件收件人语言设置的语言值。 此参数不自定义电子邮件的自定义文本,应使用与自定义文本相同的语言设置。 名称: to值: User、、 ManagersSponsors或特定userID字符串。 如果被选中,则 Sponsors 无法在参数中 cc 添加其他用户。 |
| 将代理标识赞助转移给经理 | b8f4c3d5-9e7a-4b1c-8f2d-6a5e8b9c7f4a | 无。 先决条件:
|
| 禁用用户帐户 | 1dfdfcc7-52fa-4c2e-bf3a-e3919cc12950 |
名称: disableOnPremisesAccountvalue:指示任务是否禁用同步的本地用户帐户的布尔值。 |
| 从所选组中删除用户 | 1953a66c-751c-45e5-8bfe-01462c70da3c |
名称: groupIDvalue:用户所属的有效组 ID 或以逗号分隔的组列表。 例如, "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"。 |
| 从所有组中删除用户 | b3a31406-2a15-4c9a-b25b-a658fa5f07fc | 无 |
| 从 Teams 中删除用户 | 06aa7acb-01af-4824-8899-b14e5ed788d6 |
名称: teamIDvalue:用户所属的团队的逗号分隔列表。 例如, "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"。 |
| 从所有团队中删除用户 | 81f7b200-2816-4b3b-8c5d-dc556f07b024 | 无 |
| 删除用户的所有许可证分配 | 8fa97d28-3e52-4985-b3a9-a1126f9b8b4e | 无 |
| 删除用户 | 8d18588d-9ad3-4c0f-99d0-ec215f0e3dff |
名称: deleteOnPremisesAccountvalue:指示任务是否删除同步的本地用户帐户的布尔值。 |
| 发送电子邮件以通知经理用户移动 | aab41899-9972-422a-9d97-f626014578b7 |
名称: ccvalue:要在电子邮件中抄送的用户的有效用户 ID (字符串) 。 名称: customSubjectvalue:正在发送的电子邮件的自定义主题标头。 名称: customBodyvalue:自定义电子邮件的正文。 名称: localevalue:覆盖电子邮件收件人语言设置的语言值。 不自定义电子邮件的自定义文本,并且应使用与自定义文本相同的语言进行设置。 名称: to值: User、、 ManagersSponsors或特定userID字符串。 如果被选中,则 Sponsors 无法在参数中 cc 添加其他用户。 |
| 在用户最后一天之前向经理发送电子邮件 | 52853a3e-f4e5-4eb8-bb24-1ac09a1da935 |
名称: ccvalue:要在电子邮件中抄送的用户的有效用户 ID (字符串) 。 名称: customSubjectvalue:正在发送的电子邮件的自定义主题标头。 名称: customBodyvalue:自定义电子邮件的正文。 名称: localevalue:覆盖电子邮件收件人语言设置的语言值。 不自定义电子邮件的自定义文本,并且应使用与自定义文本相同的语言进行设置。 名称: to值: User、、 ManagersSponsors或特定userID字符串。 如果被选中,则 Sponsors 无法在参数中 cc 添加其他用户。 |
| 在用户的最后一天发送电子邮件 | 9c0a1eaf-5bda-4392-9d9e-6e155bb57411 |
名称: ccvalue:要在电子邮件中抄送的用户的有效用户 ID (字符串) 。 名称: customSubjectvalue:正在发送的电子邮件的自定义主题。 名称: customBodyvalue:自定义电子邮件的正文。 名称: localevalue:覆盖电子邮件收件人语言设置的语言值。 不自定义电子邮件的自定义文本,并且应使用与自定义文本相同的语言进行设置。 名称: to值: User、、 ManagersSponsors或特定userID字符串。 如果被选中,则 Sponsors 无法在参数中 cc 添加其他用户。 |
| 在用户的经理的最后一天后向其发送登出电子邮件 | 6f22ddd4-b3a5-47a4-a846-0d7c201a49ce |
名称: ccvalue:要在电子邮件中抄送的用户的有效用户 ID (字符串) 。 名称: customSubjectvalue:正在发送的电子邮件的自定义主题标头。 名称: customBodyvalue:自定义电子邮件的正文。 名称: localevalue:覆盖电子邮件收件人语言设置的语言值。 不自定义电子邮件的自定义文本,并且应使用与自定义文本相同的语言进行设置。 名称: to值: User、、 ManagersSponsors或特定userID字符串。 如果被选中,则 Sponsors 无法在参数中 cc 添加其他用户。 |
| 发送有关用户非活动的电子邮件 | 92f74cb4-f1b6-4ec0-b766-96210f56edc2 |
名称: ccvalue:要在电子邮件中抄送的用户的有效用户 ID (字符串) 。 名称: customSubjectvalue:正在发送的电子邮件的自定义主题标头。 名称: customBodyvalue:自定义电子邮件的正文。 名称: localevalue:覆盖电子邮件收件人语言设置的语言值。 此参数不自定义电子邮件的自定义文本,应使用与自定义文本相同的语言设置。 名称: to值: User、、 ManagersSponsors或特定userID字符串。 如果被选中,则 Sponsors 无法在参数中 cc 添加其他用户。 |
| 请求用户访问包分配 | c1ec1e76-f374-4375-aaa6-0bb6bd4c60be |
名称: assignmentPolicyIdvalue:要分配给用户的访问包的有效分配策略 ID (字符串) 。 名称: accessPackageIdvalue:要分配给用户的访问包的有效访问包 ID。 |
| 删除用户的访问包分配 | 4a0b64f2-c7ec-46ba-b117-18f262946c50 |
名称: accessPackageIdvalue:要从用户取消分配的访问包的有效访问包 ID。 |
| 删除用户的所有访问包分配 | 42ae2956-193d-4f39-be06-691b8ac4fa1d | 无 |
| 取消用户的待处理访问包分配请求 | 498770d9-bab7-4e4c-b73d-5ded82a1d0b3 |
名称: daysUntilExpirationvalue:距离用户的访问包分配过期前的有效天数字符串。 |
示例
示例 1:向新员工发送欢迎电子邮件
{
"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"
}
]
}
示例 2: (TAP) 生成临时访问通行证并将其发送给用户的经理
{
"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"
}
]
}
示例 3:将用户添加到组
{
"category": "joiner,leaver",
"description": "Add user to groups",
"displayName": "AddUserToGroup",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "22085229-5809-45e8-97fd-270d28d66910",
"arguments": [
{
"name": "groupID",
"value": "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"
}
]
}
示例 4:向团队添加用户
{
"category": "joiner,leaver",
"description": "Add user to team",
"displayName": "AddUserToTeam",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "e440ed8d-25a1-4618-84ce-091ed5be5594",
"arguments": [
{
"name": "teamID",
"value": "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"
}
]
}
示例 5:更新用户属性 (预览)
{
"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\"}]"
}
]
}
示例 6: 启用用户帐户
{
"category": "joiner,leaver",
"description": "Enable user account",
"displayName": "EnableUserAccount",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "6fc52c9d-398b-4305-9763-15f42c1676fc",
"arguments": []
}
示例 7:运行自定义任务扩展
{
"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>"
}
]
}
示例 8:禁用用户帐户
{
"category": "joiner,leaver",
"description": "Disable user account",
"displayName": "DisableUserAccount",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "1dfdfcc7-52fa-4c2e-bf3a-e3919cc12950",
"arguments": []
}
示例 9:从所选组中删除用户
{
"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": "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"
}
]
}
示例 10:从所有组中删除用户
{
"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": []
}
示例 11:从所选团队中删除用户
{
"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, ..."
}
]
}
示例 12:从所有团队中删除用户
{
"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": []
}
示例 13:删除用户的所有许可证分配
{
"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": []
}
示例 14:删除用户
{
"category": "leaver",
"continueOnError": true,
"displayName": "Delete user account",
"description": "Delete user account in Azure AD",
"isEnabled": true,
"taskDefinitionId": "8d18588d-9ad3-4c0f-99d0-ec215f0e3dff",
"arguments": []
}
示例 15:发送电子邮件以通知经理用户移动
{
"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"
}
]
}
示例 16:在用户的最后一天之前向经理发送电子邮件
{
"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"
}
]
}
示例 17:在用户的最后一天发送电子邮件
{
"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"
}
]
}
示例 18:在用户工作的最后一天后向用户的经理发送登出电子邮件
{
"category": "leaver",
"continueOnError": true,
"displayName": "Send offboarding email to user's manager after the last day of work",
"description": "Send email after user's last day",
"isEnabled": true,
"continueOnError": true,
"taskDefinitionId": "6f22ddd4-b3a5-47a4-a846-0d7c201a49ce",
"arguments": []
}
示例 19:请求用户访问包分配
{
"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"
}
]
}
示例 20:删除用户的访问包分配
{
"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"
}
]
}
示例 21:删除用户的所有访问包分配
{
"category": "leaver",
"continueOnError": false,
"description": "Remove all access packages assigned to the user",
"displayName": "Remove all access package assignments for user",
"isEnabled": true,
"taskDefinitionId": "42ae2956-193d-4f39-be06-691b8ac4fa1d",
"arguments": [
{
"description": "Remove all access packages assigned to the user",
"displayName": "Remove all access package assignments for user",
"id": "42ae2956-193d-4f39-be06-691b8ac4fa1d",
"version": 1,
"parameters": [
{
"name": "daysUntilExpiration",
"values": [],
"valueType": "string"
}
]
}
]
}
示例 22:取消用户的待处理访问包分配请求
{
"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": []
}
示例 23:发送载入提醒电子邮件
{
"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"
}
]
}
示例 24:撤销用户的所有刷新令牌
{
"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": []
}
示例 25:向经理发送有关赞助更改的电子邮件
{
"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"
}
]
}
示例 26:向共同发起人发送有关发起人更改的电子邮件
{
"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": "We 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"
}
]
}
示例 27:将代理标识赞助转移给经理
{
"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": []
}
示例 28:发送有关用户不活动的电子邮件
{
"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"
}
]
}
配置 Beta 版) (身份验证载入任务
这三个身份验证载入任务是 Joiner 任务,只能通过 Microsoft Graph /beta 终结点使用,而不是 /v1.0。 使用为载入配置的身份验证配置文件。
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
使用 列出任务定义检索 任务定义。 其任务定义版本为 0,这不是 Microsoft 图形 API 版本。
所有三个任务都支持以下参数。 参数值是字符串。
| 参数 | 必需 | 行为 |
|---|---|---|
cc |
否 | 要复制到电子邮件的用户 ID 或以逗号分隔的用户 ID 列表。 如果省略,则不添加抄送收件人。 |
customBody |
否 | 自定义电子邮件正文。 如果省略,则使用标准正文。 对于两个验证链接任务,非空自定义正文必须包含 {{verificationLink}}。 |
customSubject |
否 | 自定义电子邮件主题。 如果省略,则使用标准主题。 |
locale |
否 | 覆盖收件人语言设置的语言值。 如果省略,通知服务将使用收件人首选项解析区域设置。 |
to |
否 | 收件人选择器。 支持的值和默认值取决于任务,如收件人表中所述。 |
verifiedIdProfileId |
是 | 为工作流选择的身份验证配置文件的 ID。 没有默认值。 经理验证状态电子邮件任务使用此 ID 来标识要报告的配置文件验证状态。 |
参数 to 具有以下特定于任务的行为。 填充用户的 otherMails 属性以进行验证链接传递。 若要传递到 Manager,请同时填充用户的 经理 关系和经理的 邮件 属性。
| 任务 | 支持的 to 值 |
省略时 to 为默认值 |
|---|---|---|
| 选择身份验证配置文件 (预览版) |
User/otherMails 条件 |
User/otherMails |
| 在预览) (为演示文稿选择验证验证 ID |
User/otherMails 条件 |
User/otherMails |
| 发送管理员验证状态电子邮件 (预览) |
User、 、 ManagerSponsors或特定用户的 ID |
Manager |
以下示例显示的是任务对象,而不是完整的 HTTP 请求正文。 使用 POST https://graph.microsoft.com/beta/identityGovernance/lifecycleWorkflows/workflows. 创建工作流时,请包括任务集合中的对象。 对于现有工作流, 创建一个新版本 以更改其任务配置。
在每个示例中,将 <id-verification-profile-id> 替换为为工作流选择的配置文件 ID。
发送身份验证链接
此任务向用户发送一个链接,以使用所选配置文件完成身份验证。 该示例在自定义正文中显式选择 User/otherMails 并包含所需的验证链接占位符。
{
"category": "joiner",
"continueOnError": false,
"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": "customSubject",
"value": "Complete your identity verification"
},
{
"name": "customBody",
"value": "Complete identity verification: {{verificationLink}}"
}
]
}
发送验证 ID 演示文稿链接
此任务向用户发送一个链接,以显示所选配置文件的验证 ID。 该示例省略了 to,因此传递默认为 User/otherMails. 自定义正文包括所需的验证链接占位符。
{
"category": "joiner",
"continueOnError": false,
"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": "customBody",
"value": "Present your Verified ID: {{verificationLink}}"
}
]
}
向经理发送验证状态电子邮件
此任务报告所选配置文件的验证状态。 此示例提供所需的配置文件 ID,并省略所有可选参数。 Delivery 默认为 Manager,无抄送收件人和标准电子邮件内容。 通知服务使用收件人首选项解析区域设置。
{
"category": "joiner",
"continueOnError": false,
"displayName": "Send manager verification status email (Preview)",
"isEnabled": true,
"taskDefinitionId": "c7a1f3e5-4b2d-4e8a-9f6c-3d5a7b1e2c4f",
"arguments": [
{
"name": "verifiedIdProfileId",
"value": "<id-verification-profile-id>"
}
]
}