本文提供有关信息技术（IT）开发人员的指导，以便他们可以创建自定义 Windows Workflow Foundation （WF） 活动，IT 专业人员可以使用这些活动来生成特定于其 IT 流程的 WF 工作流。 自定义 WF 活动扩展了活动库，即使用 Service Manager 创作工具分发的活动。 本文档的“工作流活动参考”部分提供活动库中默认 WF 活动的详细信息。 此信息旨在帮助开发人员（或作为开发人员的 IT 专业人士）根据需要创建自定义的 WF 活动。
有关如何将 WF 活动和 WF 工作流与 Service Manager 配合使用的信息，请参阅 使用工作流自动执行 IT 流程。
Active Directory 活动
使用 Active Directory 域服务 （AD DS） 活动使 Active Directory 在 Service Manager 中充当工作流的一部分。
Service Manager 创作工具在“活动工具箱”窗格中的“Active Directory 活动”组中提供两个默认的 Service Manager 活动。 本文中的各节介绍这些活动。
“将 AD DS 计算机添加到组”活动
此活动将计算机添加到 Service Manager 中Active Directory 域服务（AD DS）中的安全组。 计算机和组必须属于同一域，并且搜索域中的所有容器。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | 使用此活动时，请确保 Service Manager 工作流帐户具有足够的权限来修改 AD DS 中的安全组。 |
属性
将 AD DS 计算机添加到组 活动使用下表中所述的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 说明 |
|---|---|---|---|---|
| 计算机域 | ComputerDomain | 字符串 | 是 | 计算机所在的完全限定 DNS 域名（例如，contoso.com）。 |
| 计算机名称 | FullyQualifiedComputerName | 字符串 | 是 | 计算机的名称。 |
| 组名称 | FullyQualifiedGroupName | 字符串 | 是 | Active Directory 域服务组的名称。 |
将 AD DS 计算机添加到组 活动将生成下表中所述的输出。
| 显示名称 | 内部名称 | 类型 | 说明 |
|---|---|---|---|
| 输出 | 输出 | 布尔值 | 操作的结果： 如果添加成功，则为 True ; 如果失败，则为 False 。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| 无 | 无 | 无 |
将 AD DS 用户添加到组活动
此活动将用户添加到 Service Manager 中Active Directory 域服务（AD DS）中的安全组。 用户和组必须属于同一域，并且搜索域中的所有容器。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | 使用此活动时，请确保 Service Manager 工作流帐户具有足够的权限来修改 AD DS 中的安全组。 |
属性
将 AD DS 用户添加到组 活动使用下表中列出的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 说明 |
|---|---|---|---|---|
| 用户域 | UserDomain | 字符串 | 是 | 用户的完全限定的域名 (FQDN)。 |
| 用户名 | UserName | 字符串 | 是 | 用户的登录名称。 |
| 组名称 | FullyQualifiedGroupName | 字符串 | 是 | 组的 FQDN。 |
“ 将 AD DS 用户添加到组 ”活动生成下表中所述的输出。
| 显示名称 | 内部名称 | 类型 | 说明 |
|---|---|---|---|
| 输出 | 输出 | 布尔值 | 操作的结果： 如果添加成功，则为 True ; 如果失败，则为 False 。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| 无 | 无 | 无 |
控制流活动
使用控制流活动为 Service Manager 中的工作流提供结构（分支、循环或计时器延迟）。
创作工具在“活动工具箱”窗格中的“控制流”组中提供四个默认控制流活动。
延迟活动
此活动在 Service Manager 中的工作流中引入活动之间的延迟。 Delay 活动派生自 Microsoft .NET Framework DelayActivity 类。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | 无 |
属性
Delay 活动使用下表中列出的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 说明 |
|---|---|---|---|---|
| Initialize TimeoutDuration | InitializeTimeoutDuration | 内部 | 指定用于初始化 TimeoutDuration 属性的处理程序。 | |
| TimeoutDuration | TimeoutDuration | 时间跨度 | 是 | 延迟的持续时间。 |
Delay 活动不生成输出属性。
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| 无 | 有关此活动的详细信息，请参阅 .NET Framework 类库中的 DelayActivity 类 。 | 无 |
For Each 循环活动
For Each 循环活动采用对象的数组（集合）作为输入，并对集合中的每个对象重复循环中的一组活动。 例如，如果输入集合有五个对象，循环将执行五次。 如果集合是空的，则循环不会迭代。 集合中的对象数没有上限。 For Each 循环活动始终在运行工作流的计算机上运行。
For Each 循环活动是一个复合活动，其中包含两个用于活动的容器：
输入容器：此活动设置循环并定义输入集合。 可以在该角色中使用Get Incident或Get Virtual Machine活动。
循环容器：名为 ForEachChildActivity，此活动包含循环活动。 在此容器中放置的大多数 Windows Workflow Foundation (WF) 活动都有两个附加属性：当前项目和绑定属性。 对于循环容器中的每个活动，请按如下所示设置这些属性：
将“当前项”设置为“ForEach”活动的“循环容器”活动的“当前项”属性。 如果此活动是For Each 循环活动中的第一个活动，当前项会被自动设置。
将“要绑定的属性”属性的值设置为使用“当前项”值的当前活动属性的值。
两类活动不会获取 当前项 和 用于绑定的属性 属性，因此无法使用输入集合中的对象：
脚本活动，例如 Windows PowerShell 脚本 活动。
不继承自 WorkflowActivityBase 类的自定义活动或其他活动。 此类活动包括基于活动基类的活动，例如本机 Visual Studio 活动。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | 无 |
属性
For Each 循环活动使用下表中所述的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 说明 |
|---|---|---|---|---|
| 输入集合 | InputCollection | 数组/对象 | 空值 | 需要逐个传递给 For Each 循环活动中的每个活动的对象集合。 如果驻留在输入容器中的活动生成对象数组作为其输出属性， 则输入集合 将自动设置为该属性。 若要查看此属性的当前值，请右键单击循环容器，然后选择“ 属性”。 |
| 当前项 | CurrentItem | 物体 | 空值 | 在循环中，活动可以使用输入集合中的索引作为输入属性。 对于循环容器中的第一个活动，将自动设置此属性。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| For Each 循环活动使用 Service Manager 提供的自定义跟踪服务来记录活动运行时的错误和异常。 活动在以下情况下生成错误或异常： - 如果ForEachLoop活动中发生任何错误，并且该错误不属于子活动，则工作流将终止。 - 如果在子活动中发生任何错误，则工作流将终止，除非 ContinueOnError=true。 - 如果任一输入属性为 null。 该活动不会迭代。 For Each Loop 活动中的每个活动都必须将其自身的错误或异常写入自定义跟踪服务。 For Each 循环活动本身不会这样做。 |
无 | 无 |
IfElse 活动
此活动基于布尔值（True/False）条件控制工作流中的活动序列。 可以将之前活动的结果（如脚本活动）作为条件。
IfElse 活动是使用规则和条件的 Visual Studio 活动。 有关在 Windows Workflow Foundation 中使用规则和条件的详细信息，请参阅 教程：在 MSDN 库中使用 WF 中的规则和条件。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | 无 |
属性
无。
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| 无 | 有关 IfElse 活动的详细信息，请参阅 .NET Framework 4 类库中的 IfElseActivity 类。 | 无 |
并行活动
此活动将活动序列分叉为两个同时进行的活动序列。 并行活动是 Visual Studio 活动。 有关 ParallelActivity 类的详细信息，请参阅 .NET Framework 类库中的 ParallelActivity 类。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | 无 |
属性
无。
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| 无 | 无 | 无 |
虚拟机管理器活动
使用 Service Manager 中的虚拟机管理活动生成允许创建和更新虚拟机的工作流。 虚拟机管理活动支持 System Center Virtual Machine Manager。
Service Manager 创作工具在“活动工具箱”窗格中的“VMM 活动”组中提供以下五个默认虚拟机管理活动。
获取 VM 活动
Service Manager 中的此活动从 Virtual Machine Manager （VMM） 库中检索一个或多个虚拟机 ID 的列表。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | - Virtual Machine Manager 控制台和服务管理器必须同时安装在同一服务器上。 - 确保 Service Manager 工作流帐户具有足够的权限来修改Active Directory 域服务（AD DS）中的安全组。 - Virtual Machine Manager 控制台和服务管理器必须同时安装在同一服务器上。 - 确保 Service Manager 工作流帐户具有足够的权限来修改Active Directory 域服务（AD DS）中的安全组。 |
属性
“ 获取 VM ”活动使用下表中的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 说明 |
|---|---|---|---|---|
| 参数集 | ParameterSet | 字符串 | 不;默认值为 Connection。 | 指定为特定用途组织的参数的子集。 对于“获取 VM”活动，可以选择以下参数集之一： - 全部： 搜索所有可用的虚拟机。 - ID： 搜索具有已知 ID 的虚拟机。 - 连接：搜索连接到 VMMServer 属性指定的 Virtual Machine Manager （VMM） 服务器的虚拟机。 - VMHostGroup：搜索与由VM 主机属性指定的虚拟机主机相连的虚拟机。 |
| 出错时继续 | ContinueOnError | 布尔值 | 否。 （默认设置为 True。） | 确定如果活动失败，工作流是否应继续运行。 |
| 出现错误 | HasError | 空值 | 指定活动是否有错误集。 （只读） | |
| All | All | 布尔值 | 否。 （默认设置为 True。） | 如果参数集是全部，则可用。 如果设置为 True， 则 Get VM 活动将返回所有可用虚拟机的虚拟机 ID 的列表。 |
| 身份证件 | 身份证件 | 字符串 | 如果参数集是ID，则为必需。 | 如果 参数集 为 ID，则可用。 如果设置为 True， 则 Get VM 活动将返回其虚拟机 ID 与指定 ID 值的全部或部分匹配的所有虚拟机的虚拟机 ID 的列表。 |
| 管理组 | ManagementGroup | 字符串 | 否 | 指定运行此活动的管理组。 设置为 localhost。 （只读） |
| 脚本服务器 | 目标 | 字符串 | 是 | 指定运行 Service Manager 控制台的服务器的域名系统（DNS）名称。 请勿使用 localhost。 |
| 脚本时间限制 | TimeoutSeconds | 整数 | 否。 （默认设置为 300 秒。 | 指定允许活动运行的最大秒数。 |
| VM 主机 | VMHost | 字符串 | 如果 参数集 是 VMHostGroup，则为必需。 | 如果 参数集 为 VMHostGroup，则可用。 如果选择此参数集， 则 Get VM 活动将返回指定主机上运行的所有虚拟机的虚拟机 ID 的列表。 |
| VM 名称 | 虚拟机名称 | 字符串 | 否 | 指定要搜索的虚拟机的名称或部分名称。 如果字符串是名称的一部分，活动将检索包含该字符串的所有虚拟机的 ID。 |
| VMMServer | VMMServer | 字符串 | 是 | 指定管理虚拟机的 System Center Virtual Machine Manager （VMM） 服务器的名称。 |
“获取 VM”活动生成下表中所述的输出。
| 显示名称 | 内部名称 | 类型 | 注释 |
|---|---|---|---|
| VM ID | 虚拟机ID列表 | 字符串数组 | 指定与 VM 名称字符串的所有或部分匹配的名称的虚拟机 ID 的列表。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| Get VM 活动使用 Service Manager 提供的自定义跟踪服务来记录活动运行时的错误和异常。 如果无法解析任何脚本属性，则活动会根据需要生成错误或异常。 | 无 | 无 |
移动 VM 活动
Service Manager 中的此活动将虚拟机从 Virtual Machine Manager （VMM） 库移到维护主机。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | - Virtual Machine Manager 控制台和服务管理器必须同时安装在同一服务器上。 - 确保 Service Manager 工作流帐户具有足够的权限来修改Active Directory 域服务（AD DS）中的安全组。 |
属性
移动 VM 活动使用下表中的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 说明 |
|---|---|---|---|---|
| 出错时继续 | ContinueOnError | 布尔值 | 否。 （默认设置为 True。） | 确定如果活动失败，工作流是否应继续运行。 |
| 出现错误 | HasError | 空值 | 指定活动是否有错误集。 （只读） | |
| 如果主机繁忙，则屏蔽 LM | BlockLMIfHostBusy | 布尔值 | 否。 （默认设置为 False。） | 如果迁移失败，则阻止重试 Hyper-V 实时迁移，因为源主机或目标主机已参与另一个实时迁移。 |
| 作业组 | JobGroup | Guid（字符串） | 否 | 指定一个标识符用于一组作为整体运行的命令。 |
| 作业变量 | JobVariable | 字符串 | 否 | 指定在由该参数命名的变量中跟踪和存储作业进度。 |
| 管理组 | ManagementGroup | 字符串 | 否 | 指定运行此活动的管理组。 设置为 localhost。 （只读） |
| 路径 | 路径 | 字符串 | 否 | 指定虚拟机在维护主机上的位置。 |
| PROTipID | PROTipID | Guid | 否 | 指定触发此操作的性能和资源优化（PRO）提示的 ID。 允许将来审核 PRO 提示。 |
| 异步运行 | RunAsynchronously | 布尔值 | 否。 （默认设置为 False。） | 指定作业以异步方式运行，以便控件立即返回到命令行界面。 |
| 脚本服务器 | 目标 | 字符串 | 是 | 指定运行 Service Manager 控制台的服务器的域名系统（DNS）名称。 请勿使用 localhost。 |
| 脚本时间限制 | TimeoutSeconds | 整数 | 否。 （默认设置为 300 秒。 | 指定允许活动运行的最大秒数。 |
| 在目标上启动 VM | StartVMOnTarget | 布尔值 | 否。 （默认设置为 False。） | 指定虚拟机到达其目标主机后立即启动。 |
| 使用集群 | UseCluster | 布尔值 | 否。 （默认设置为 False。） | 强制使用 Windows Server 2008 群集迁移将处于保存状态的虚拟机传输到主机，即使群集支持 Hyper-V 实时迁移。 |
| 使用局域网 | UseLan | 布尔值 | 否。 （默认设置为 False。） | 即使有更快的传输机制（例如存储区域网络（SAN）传输），也强制通过局域网（LAN）进行传输。 |
| VM 主机 | VMHostName | 字符串 | 是 | 指定将虚拟机移动到的维护主机的名称。 |
| 虚拟机ID | VMID | 字符串 | 是 | 指定要移动的虚拟机的唯一 ID。 |
| VMM 服务器 | VMMServer | 字符串 | 是 | 指定管理虚拟机的 System Center Virtual Machine Manager （VMM） 服务器的名称。 |
移动 VM 活动生成下表中所述的输出。
| 显示名称 | 内部名称 | 类型 | 注释 |
|---|---|---|---|
| 虚拟机ID | VMID | 字符串 | 指定已移动的虚拟机的唯一 ID。 除非活动找不到与输入 VM ID 匹配的 VM ID 的虚拟机，否则输入 VM ID 和输出 VM ID 是相等的。 在这种情况下，输出 VM ID 设置为 Null。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| 移动 VM 活动使用 Service Manager 提供的自定义跟踪服务来记录活动运行时的错误和异常。 如果无法解析任何脚本属性，则活动会根据需要生成错误或异常。 | 无 | 无 |
关闭 VM 活动
Service Manager 中的此活动关闭虚拟机上的来宾操作系统。
只有在虚拟机安装了虚拟化来宾服务时，才能在基于 Windows 的主机（Hyper-V 主机或虚拟服务器主机）上使用关闭 VM 活动。 对于部署在 Hyper-V 主机上的虚拟机，虚拟化来宾服务称为集成组件。 对于部署在虚拟服务器主机上的虚拟机，虚拟化来宾服务称为“虚拟机添加”。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | - Virtual Machine Manager 控制台和服务管理器必须同时安装在同一服务器上。 - 确保 Service Manager 工作流帐户具有足够的权限来修改Active Directory 域服务（AD DS）中的安全组。 |
属性
关闭 VM 活动使用下表中所述的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 说明 |
|---|---|---|---|---|
| 出错时继续 | ContinueOnError | 布尔值 | 否。 （默认设置为 True。） | 确定如果活动失败，工作流是否应继续运行。 |
| 出现错误 | HasError | 空值 | 指定活动是否有错误集。 （只读） | |
| 作业变量 | JobVariable | 字符串 | 否 | 指定跟踪作业进度并将其存储在由此参数命名的变量中。 |
| 管理组 | ManagementGroup | 字符串 | 否 | 指定运行此活动的管理组。 设置为 localhost。 （只读） |
| PROTipID | PROTipID | Guid | 否 | 指定触发此操作的性能和资源优化（PRO）提示的 ID。 允许将来审核 PRO 提示。 |
| 异步运行 | RunAsynchronously | 布尔值 | 否。 （默认设置为 False。） | 指定作业以异步方式运行，以便控件立即返回到命令行界面。 |
| 脚本服务器 | 目标 | 字符串 | 是 | 指定运行 Service Manager 控制台的服务器的域名系统（DNS）名称。 请勿使用 Localhost。 |
| 脚本时间限制 | TimeoutSeconds | 整数 | 否。 （默认设置为 300 秒。 | 指定允许活动运行的最大秒数。 |
| 虚拟机ID | VMID | 字符串 | 是 | 指定要关闭的虚拟机的唯一 ID。 |
| VMMServer | VMMServer | 字符串 | 是 | 指定管理虚拟机的 System Center Virtual Machine Manager （VMM） 服务器的名称。 |
关闭 VM 活动生成下表中所述的输出。
| 显示名称 | 内部名称 | 类型 | 注释 |
|---|---|---|---|
| 虚拟机ID | VMID | 字符串 | 指定已关闭的虚拟机的唯一 ID。 除非活动找不到与输入 VM ID 匹配的 VM ID 的虚拟机，否则输入 VM ID 和输出 VM ID 是相等的。 在这种情况下，输出 VM ID 设置为 Null。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| 关闭 VM 活动使用 Service Manager 提供的自定义跟踪服务来记录活动运行时的错误和异常。 如果无法解析任何脚本属性，则活动会根据需要生成错误或异常。 | 无 | 无 |
启动 VM 活动
Service Manager 中的此活动启动已停止或暂停的虚拟机。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | 无 |
属性
启动 VM 活动使用下表中的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 说明 |
|---|---|---|---|---|
| 出错时继续 | ContinueOnError | 布尔值 | 否。 （默认设置为 True。） | 确定如果活动失败，工作流是否应继续运行。 |
| 出现错误 | HasError | 空值 | 指定活动是否有错误集。 （只读） | |
| 作业变量 | JobVariable | 字符串 | 否 | 指定跟踪作业进度并将其存储在由此参数命名的变量中。 |
| 管理组 | ManagementGroup | 字符串 | 否 | 将运行此活动的管理组。 设置为 localhost。 （只读） |
| PROTipID | PROTipID | Guid | 否 | 指定触发此操作的性能和资源优化（PRO）提示的 ID。 允许将来审核 PRO 提示。 |
| 异步运行 | RunAsynchronously | 布尔值 | 否。 （默认设置为 False。） | 指定作业以异步方式运行，以便控件立即返回到命令行界面。 |
| 脚本服务器 | 目标 | 字符串 | 是 | 指定运行 Service Manager 控制台的服务器的域名系统（DNS）名称。 请勿使用 localhost。 |
| 脚本时间限制 | TimeoutSeconds | 整数 | 否。 （默认设置为 300 秒。 | 指定允许活动运行的最大秒数。 |
| 虚拟机ID | VMID | 字符串 | 是 | 指定要启动的虚拟机的唯一 ID。 |
| VMMServer | VMMServer | 字符串 | 是 | 指定管理虚拟机的 System Center Virtual Machine Manager （VMM） 服务器的名称。 |
启动 VM 活动生成下表中所述的输出。
| 显示名称 | 内部名称 | 类型 | 注释 |
|---|---|---|---|
| 虚拟机ID | VMID | 字符串 | 指定已启动的虚拟机的唯一 ID。 除非活动找不到与输入 VM ID 匹配的 VM ID 的虚拟机，否则输入 VM ID 和输出 VM ID 是相等的。 在这种情况下，输出 VM ID 设置为 Null。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| 启动 VM 活动使用 Service Manager 提供的自定义跟踪服务来记录活动运行时的错误和异常。 活动会根据需要生成错误或异常（如果无法解析任何脚本属性）。 | 无 | 无 |
保存 VM 状态活动
Service Manager 中的此活动保存虚拟机的状态，然后停止虚拟机。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | - Virtual Machine Manager 控制台和服务管理器必须同时安装在同一服务器上。 - 确保 Service Manager 工作流帐户具有足够的权限来修改Active Directory 域服务（AD DS）中的安全组。 |
属性
保存状态 VM 活动使用下表中所述的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 说明 |
|---|---|---|---|---|
| 出错时继续 | ContinueOnError | 布尔值 | 否。 （默认设置为 True。） | 确定如果活动失败，工作流是否应继续运行。 |
| 出现错误 | HasError | 空值 | 指定活动是否有错误集。 （只读） | |
| 作业变量 | JobVariable | 字符串 | 否 | 指定跟踪作业进度并将其存储在由此参数命名的变量中。 |
| 管理组 | ManagementGroup | 字符串 | 否 | 指定运行此活动的管理组。 设置为 localhost。 （只读） |
| PROTipID | PROTipID | Guid | 否 | 指定触发此操作的性能和资源优化（PRO）提示的 ID。 允许将来审核 PRO 提示。 |
| 异步运行 | RunAsynchronously | 布尔值 | 否。 （默认设置为 False。） | 指定作业以异步方式运行，以便控件立即返回到命令行界面。 |
| 脚本服务器 | 目标 | 字符串 | 是 | 指定运行 Service Manager 控制台的服务器的域名系统（DNS）名称。 请勿使用 localhost。 |
| 脚本时间限制 | TimeoutSeconds | 整数 | 否。 （默认设置为 300 秒。 | 指定允许活动运行的最大秒数。 |
| 虚拟机ID | VMID | 字符串 | 是 | 指定要保存的虚拟机的唯一 ID。 |
| VMM 服务器 | VMMServer | 字符串 | 是 | 指定管理虚拟机的 System Center Virtual Machine Manager （VMM） 服务器的名称。 |
保存 状态 VM 活动生成下表中所述的输出。
| 显示名称 | 内部名称 | 类型 | 注释 |
|---|---|---|---|
| 虚拟机ID | VMID | 字符串 | 指定已保存的虚拟机的唯一 ID。 除非活动找不到与输入 VM ID 匹配的 VM ID 的虚拟机，否则输入 VM ID 和输出 VM ID 是相等的。 在这种情况下，输出 VM ID 设置为 Null。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| 保存状态 VM 活动使用 Service Manager 提供的自定义跟踪服务来记录活动运行时的错误和异常。 如果无法解析任何脚本属性，则活动会根据需要生成错误或异常。 | 无 | 无 |
脚本活动
使用 Service Manager 中的脚本活动将脚本作为工作流的一部分运行。
脚本活动作为工作流中的单独过程运行；但是，它们还在 Service Manager 工作流帐户的安全上下文中运行。
Service Manager 创作工具在“活动工具箱”窗格中“脚本活动”组的“常规脚本活动”子组中提供以下三个默认脚本活动。
命令脚本活动
此活动作为 Windows Workflow Foundation （WF） 工作流的一部分运行命令行脚本。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | 无 |
属性
命令 脚本 活动使用下表中所述的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 说明 |
|---|---|---|---|---|
| 出错时继续 | ContinueOnError | 布尔值 | 否。 （默认设置为 True。） | 确定如果活动失败，工作流是否应继续运行。 |
| 出现错误 | HasError | 空值 | 指定活动是否有错误集。 （只读） | |
| 管理组 | 管理组名称 | 字符串 | 否 | 指定脚本服务器所属的管理组。 默认情况下，此值设置为 localhost。 （只读） |
| 脚本参数 | 参数 | 字典 <string,string> | 是 | 指定要在运行脚本时传递给脚本的命令行开关或开关/值对。 |
| 脚本正文 | ScriptBody | 字符串 | 是 | 指定脚本本身的文本。 |
| 脚本服务器 | 目标 | 字符串 | 否 | 指定运行 Service Manager 控制台的服务器的域名系统（DNS）名称。 请勿使用 localhost。 |
| 脚本时间限制 | TimeoutSeconds | 整数 | 否。 （默认设置为 300 秒。 | 指定允许脚本运行的最大秒数。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| 命令 脚本 活动使用 Service Manager 提供的自定义跟踪服务来记录活动运行时的错误和异常。 如果无法解析任何脚本属性，则活动会根据需要生成错误或异常。 | 无 | 无 |
Windows PowerShell 脚本活动
Service Manager 中的此活动作为 Windows Workflow Foundation （WF） 工作流的一部分运行 Windows PowerShell 脚本。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| Windows PowerShell 脚本活动取决于设计时满足以下先决条件： - Windows PowerShell 2.0 |
Windows PowerShell 2.0 |
属性
Windows PowerShell 脚本活动使用下表中所述的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 说明 |
|---|---|---|---|---|
| 出错时继续 | ContinueOnError | 布尔值 | 否。 （默认设置为 True。） | 确定如果活动失败，工作流是否应继续运行。 |
| 出现错误 | HasError | 空值 | 指定活动是否有错误集。 （只读） | |
| 管理组 | 管理组名称 | 字符串 | 否 | 指定脚本服务器所属的管理组。 默认情况下，此值设置为 localhost。 （只读） |
| 脚本参数 | 参数 | 字典 <string,string> | 是 | 指定要在运行脚本时传入脚本的参数的名称/值列表。 可以将参数值设置为以下任一管理包引用： - $Target/...$ - $MPElement[...] - $Data/...$。 $Data 引用仅在作为参数传递时，才于运行时进行解析（而非在脚本自身中）。 使用这些引用之一作为参数的唯一值，将该参数设置为表示输入数据项的 XML 字符串（来自GetItemXML）。 |
| 脚本正文 | ScriptBody | 字符串 | 是 | 指定脚本本身的文本。 |
| 管理单元 | SnapIns | 字符串 | 否 | 列出要预加载到运行空间的 Windows PowerShell 管理单元。 |
| 脚本服务器 | 目标 | 字符串 | 否 | 指定运行 Service Manager 控制台的服务器的域名系统（DNS）名称。 请勿使用 localhost。 |
| 脚本时间限制 | TimeoutSeconds | 整数 | 否。 （默认设置为 300 秒。 | 指定允许脚本运行的最大秒数。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| Windows PowerShell 脚本活动使用 Service Manager 提供的自定义跟踪服务来记录活动运行时的错误和异常。 如果无法解析任何脚本属性，则活动会根据需要生成错误或异常。 | 有关 Windows PowerShell 的详细信息，请参阅 Windows PowerShell。 | 无 |
VBScript 脚本活动
Service Manager 中的此活动在 Windows Workflow Foundation （WF） 工作流中运行 VBScript 脚本。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| VBScript 脚本活动在设计时取决于以下先决条件： 无。 |
无 |
属性
VBScript 脚本活动使用下表中所述的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 说明 |
|---|---|---|---|---|
| 出错时继续 | ContinueOnError | 布尔值 | 否。 （默认设置为 True。） | 确定工作流是否在活动失败时继续运行。 |
| 出现错误 | HasError | 空值 | 指定活动是否有错误集。 （只读） | |
| 管理组 | 管理组名称 | 字符串 | 否 | 指定脚本服务器所属的管理组。 （默认情况下，此设置为 localhost） （只读） |
| 脚本参数 | 参数 | 字典 <string,string> | 是 | 提供标准开关的列表以及此脚本在运行时使用的任何关联值。 |
| 脚本正文 | ScriptBody | 字符串 | 是 | 指定脚本本身的文本。 |
| 脚本服务器 | 目标 | 字符串 | 否 | 指定运行 Service Manager 控制台的服务器的域名系统（DNS）名称。 请勿使用 localhost。 |
| 脚本时间限制 | TimeoutSeconds | 整数 | 否。 （默认设置为 300 秒。 | 指定允许脚本运行的最大秒数。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| VBScript 脚本活动使用 Service Manager 提供的自定义跟踪服务来记录活动运行时的错误和异常。 如果无法解析任何脚本属性，则活动会根据需要生成错误或异常。 | 无 | 无 |
Service Manager 活动
使用 Service Manager 中的 Service Manager 活动使 Service Manager 功能成为工作流的一部分。
Service Manager 创作工具在“活动工具箱”窗格中的 SM 活动组中提供以下四个默认 Service Manager 活动。
创建事件活动
此活动在 Service Manager 中创建并填充事件。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | 无 |
属性
创建事件活动使用下表中列出的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 注释 |
|---|---|---|---|---|
| 事件 ID | 事件ID | 字符串 | 是 | 指定为 Incident 对象生成的唯一标识符。 |
| 操作日志注释 | ActionLogComment | 字符串 | 是 | 指定要包含在 Incident 对象的操作日志中的注释。 |
| 受影响的用户域 | 受影响用户域 | 字符串 | 是 | 指定受事件影响的主要用户的域名系统（DNS）域的名称。 |
| 受影响的用户名 | AffectedUserName | 字符串 | 是 | 指定受事件影响的主要用户的用户名。 |
| 类别 | 类别 | 整数 | 是 | 指定事件类型，例如 网络 或 打印。 该值是 enum 的 ID。 （类别 -enum 数据字段） |
| 出错时继续 | ContinueOnError | 布尔值 | 否。 （默认设置为 true。） | 确定如果活动失败，工作流是否应继续运行。 |
| 影响 | 影响 | 整数 | 是 | 指定事件对受影响用户或用户的影响。 该值是 enum 的 ID。 （影响 -enum 数据类型） |
| 来源 | 来源 | 整数 | 否 | 指定有关事件的信息来源，例如 电话 或 电子邮件。 该值是 enum 的 ID。 （源于枚举数据类型字段） |
| 总结 | 总结 | 字符串 | 是 | 指定描述事件的摘要文本。 |
| 紧急性 | 紧急性 | 整数 | 是 | 指定解决事件的紧迫性。 该值是 enum 的 ID。 （紧急 -enum 数据类型字段） |
创建事件活动生成下表中所述的输出。
| 名称 | 类型 | 注释 |
|---|---|---|
| SM 事件 | System.WorkItem.Incident | 返回构造的事件类实例。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| 无 | 无 | 无 |
获取事件活动
此活动检索 Service Manager 中的一个或多个事件。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | 无 |
属性
Get Incident 活动使用下表中列出的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 注释 |
|---|---|---|---|---|
| 受影响的用户域 | 受影响用户域 | 字符串 | 否 | 指定受事件影响的主要用户的域名系统（DNS）域的名称。 |
| 受影响的用户名 | AffectedUserName | 字符串 | 否 | 指定受事件影响的主要用户的用户名。 |
| 类别 | 类别 | 整数 | 否 | 指定事件类型，例如 网络 或 打印。 该值是 enum 的 ID。 （类别 -enum 数据字段） |
| 出错时继续 | ContinueOnError | 布尔值 | 否。 （默认值为 true。） | 确定如果活动失败，工作流是否应继续运行。 |
| 事件 ID | 事件ID | 字符串 | 否 | 指定为事件对象生成的唯一标识符。 |
| 搜索类型 | 搜索类型 | 整数 | 否 | 指定与活动一起使用的搜索类型的标题。 |
| 状态 | 状态 | 整数 | 否 | 指明事件的状态。 该值是 enum 的 ID。 （状态 -enum 数据字段） |
| 摘要文本 | 摘要文本 | 字符串 | 否 | 指定描述事件的摘要文本。 |
Get Incident 活动生成下表中所述的输出。
| 显示名称 | 内部名称 | 类型 | 注释 |
|---|---|---|---|
| SM 事件 | SMIncidents | System.Workitem.Incident 的数组 | 指定事件对象的数组。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| 无 | Get Incident 活动有自己的验证程序，用于对输入属性执行错误验证。 | 无 |
更新事件活动
Service Manager 中的此活动将属性更改保存到一个 Service Manager 事件。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | 无 |
属性
更新事件活动使用下表中所述的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 说明 |
|---|---|---|---|---|
| 操作日志注释 | ActionLogComment | 字符串 | 否 | 指定要包含在 Incident 对象的操作日志中的注释。 |
| 受影响的用户域 | 受影响用户域 | 字符串 | 否 | 指定受事件影响的主要用户的域名系统（DNS）域的名称。 |
| 受影响的用户名 | AffectedUserName | 字符串 | 否 | 指定受事件影响的主要用户的用户名。 |
| 类别 | 类别 | 整数 | 否 | 指定事件类型，例如 网络 或 打印。 该值是 enum 的 ID。 （类别 -enum 数据类型） |
| 出错时继续 | ContinueOnError | 布尔值 | 否。 （默认设置为 true。） | 确定如果活动失败，工作流是否应继续运行。 |
| 影响 | 影响 | 整数 | 否 | 指定事件对受影响用户或用户的影响。 该值是 enum 的 ID。 （影响 -enum 数据类型） |
| 来源 | 来源 | 整数 | 否 | 指定有关事件的信息来源，例如 电话 或 电子邮件。 该值是 enum 的 ID。 （源 -enum 数据类型） |
| Service Manager 事件 | SM事件 | System.Workitem.Incident | 否 | 要更新的已构建事件类实例。 |
| 状态 | 状态 | 整数 | 否 | 指定生成活动的事件的状态。 该值是 enum 的 ID。 （状态 -enum 数据类型） |
| 总结 | 总结 | 字符串 | 否 | 指定描述事件的摘要文本。 |
| 紧急性 | 紧急性 | 整数 | 否 | 指定解决事件的紧迫性。 该值是 enum 的 ID。 （紧急 -enum 数据类型字段） |
更新 事件 活动生成下表中所述的输出。
| 显示名称 | 内部名称 | 类型 | 说明 |
|---|---|---|---|
| SM 事件 | SMIncident | System.WorkItem.Incident | 返回事件类实例的更新。 除非活动未能找到SM 事件，否则输入SM 事件和输出SM 事件是相等的。 在这种情况下，输出 SM 事件 设置为 Null。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| 无 | 无 | 无 |
将活动状态设置为“已完成”活动
此活动更新 Service Manager 中自动活动的状态。
| 设计时先决条件 | 运行时先决条件 |
|---|---|
| 无 | 无。 |
属性
“ 将活动状态设置为已完成 ”活动使用下表中所述的输入属性。
| 显示名称 | 内部名称 | 类型 | 必需 | 说明 |
|---|---|---|---|---|
| 活动编号 | ActivityID | 字符串 | 是 | 指定服务管理器自动化活动对象的标识符。 |
| 错误和异常 | 注解 | 示例 |
|---|---|---|
| 无 | 在 Service Manager 自动化活动触发的工作流中使用此活动时，请输入 $Data/BaseManagedEntityId$ 作为此属性的值。 此值适用于 触发工作流运行的自动化活动的“将活动状态设置为已完成 ”活动。 | 无 |