实验室管理工具版工作流活动

在自定义一个Lab Management工作流模板(LabDefaultTemplate.11.xaml)，您可以使用一个或多个预定义的Lab Management活动。 也可以访问通过 Lab Management 向导创建的对象。 本主题介绍在您自定义工作流模板以生成、部署和测试应用程序时，可用的 Team Foundation Lab Management 活动和对象。 有关如何在自定义工作流中使用这些活动的信息，请参见自定义 Lab Management 工作流。

要求

• Visual Studio 旗舰版, Visual Studio 高级专业版, Visual Studio 专业测试工具版

本主题包含以下各节：

1. Lab Management 活动

2. Lab Management 类

Lab Management 活动

下表介绍了各个 Lab Management 工作流活动。

活动	说明
CreateLabEnvironment	从存储模板中创建一个新环境，然后将该环境部署到指定的主机组上。
DeleteLabEnvironment	删除环境。
DeleteSnapshot	删除环境快照。
ExecuteRemoteTestRun	在环境中创建一个测试运行，并等待该测试运行完成。
GenerateEnvironmentViewerFile	生成具有快照链接 ID 的环境查看器。 它用于连接到环境快照。
GetBuildLocationAndBuildNumber	返回生成、部署和测试方案的生成位置与生成号。
GetLabEnvironmentInUseMarker	返回环境的“正在使用”标记。
GetLabEnvironmentSnapshotId	获取环境快照的 ID。
GetLabEnvironmentStatus	获取环境状态。
GetLabEnvironmentUri	获取给定环境名称和实验室位置名称的环境 URI。
InitializeAgentSpecAndEnvironmentVariables	分析属性指定的部署脚本详细信息
ResetLabEnvironmentInuseMarker	重置环境的“正在使用”标记。
RestoreLabEnvironment	将环境还原为指定快照。
RunDeploymentScript	运行部署脚本。 在失败时，会引发或写入 ThrowOnError 属性中指定的一个生成警告。
RunWorkflow	在生成服务器的生成控制器上，对新工作流进行排队。
SaveLabEnvironment	创建一个新环境，然后将该环境存储到团队项目库共享中。
SetLabEnvironmentInuseMarker	设置环境的“正在使用”标记。
SnapshotLabEnvironment	拍摄环境的快照。
StartLabEnvironment	启动环境。
StopLabEnvironment	停止环境。
WaitForTestCapabilityServices	等待环境的测试功能准备就绪所需的指定最长时间。 在到达该等待时间时，如果测试功能未就绪，则会引发超时异常。
WaitForWorkflow	工作流的类型。
WaitForWorkflowCapabilityServices	等待完成排队生成所需的给定最长时间。 如果生成工作流在给定的最长时间内未完成，则会引发 TimeOutException。 活动会定期检查排队生成的状态以确定已完成哪些生成。 通过使用 RefreshInterval 属性配置此时间间隔。
WriteDeploymentInformation	写入包含在生成摘要中的部署信息。

CreateLabEnvironment

从存储模板中创建一个新环境，然后将该环境部署到指定的主机组上。 此活动会运行较长时间，并会一直等到创建新的环境。 如果无法创建新的实验室环境，则此活动会引发 LabDeploymentProcessException 异常。

属性

LabEnvironmentName	新环境的名称。 如果此属性为 null 或为空，则将使用环境模板名称。
LabEnvironmentTemplateUri	存储环境模板的 URI。 可通过使用 GetLabEnvironmentUri 活动来获取此实验室环境模板 URI。 必需。
TeamProjectHostGroupName	新环境将部署到的主机组。 如果未找到指定的主机组，则会引发 NoTeamProjectHostGroupFoundException 异常。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

DeleteLabEnvironment

删除环境。 此活动会运行较长时间，并会一直等到删除该环境。 如果删除环境失败，则此活动会引发 LabDeploymentProcessException 异常。

属性

LabEnvironmentUri

要删除的环境的 URI。 可通过使用 GetLabEnvironmentUri 活动来获取此实验室环境 URI。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

DeleteSnapshot

删除环境快照。 此活动会运行较长时间，并会一直等到删除该快照。 如果删除快照失败，则此活动会引发 LabDeploymentProcessException 异常。

属性

LabEnvironmentUri	将删除其快照的实验室环境的 URI。 可通过使用 GetLabEnvironmentUri 活动来获取此实验室环境 URI。 必需。
SnapshotId	要删除的快照的 ID。 可通过使用 GetLabEnvironmentSnapshotId 活动来获取此快照 ID。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

ExecuteRemoteTestRun

在环境中创建一个测试运行，并等待该测试运行完成。 此活动会运行较长时间，并会一直等到测试运行完成或发生超时。 可以使用 MaxWaitTime 属性设置超时。 此活动会定期检查测试运行状态以确定已完成哪些测试运行。 通过使用 RefreshInterval 属性配置此时间间隔。 MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion 属性可在检查测试运行的状态时用于指定要忽略 Team Foundation Server 错误的连续次数。

返回值

一个 TestRunStatistics 对象，它存储测试运行的详细信息。

属性

BuildNumber	对其运行测试的生成号。
LabEnvironmentUri	在其上执行测试用例的环境的 URI。 可通过使用 GetLabEnvironmentUri 活动来获取此环境 URI。
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion	在活动等待测试运行时，应忽略的最大连续失败次数。 此属性的默认值为 3。
MaxWaitTime	TimeSpan，指定等待测试运行完成的最长时间。 在到达指定持续时间时会引发超时异常。 默认值为 0（零），这意味着活动会无限期地等待。
RefreshInterval	TimeSpan，指定刷新测试运行状态的时间间隔。 此间隔的默认值是 60 秒。
TestDirectory	测试可执行文件的路径。
TestEnvironment	将在其中执行测试用例的测试环境的名称。
TestParameters	一个 RunTestDetails 对象，它指定测试计划、测试套件、测试设置和测试配置等测试参数。 必需。
标题	测试运行的名称。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

GenerateEnvironmentViewerFile

生成包含快照链接 ID 的环境查看器文件。 此活动用于连接到环境快照。 环境查看器文件的名称是不包含以下任一特殊字符的快照名称：@"[`~!@#$%^&*()+=[{\]}|\\;:',/?]" + "\""。

属性

FilePath	存储环境查看器文件的 UNC 路径。 生成服务帐户必须具有路径的写入权限。 必需。
LabEnvironmentUri	环境的 URI。 可通过使用 GetLabEnvironmentUri 活动来获取此环境 URI。 必需。
SnapshotId	快照的 ID。 可通过使用 GetLabEnvironmentSnapshotId 活动来获取快照 ID。 如果快照无效，则会引发 InvalidSnapshotException 异常。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

GetBuildLocationAndBuildNumber

返回生成、部署和测试方案的生成位置与生成号。 如果选择了“团队生成”，并且生成的 URI 为 null，则会选择上一个好生成并返回详细信息。 如果未找到上一个好生成，则会引发 System.ArgumentException。 如果未选择“团队生成”，则仅返回用户指定的生成位置。

返回值

指定生成位置的 String。

属性

BuildDetails	一个 Microsoft.TeamFoundation.Lab.Workflow.Activities.BuildDetails 对象，它包括生成、部署和测试方案中与生成相关的信息。
BuildNumber	选定生成的生成号。 这是一个 outArgument。 对于非“团队生成”生成，为 null。
SelectedBuild	有关生成服务器的生成信息。 这是一个 outArgument。 对于非“团队生成”生成，为 null。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

GetLabEnvironmentInUseMarker

获取环境的“正在使用”标记。

返回值

一个 LabEnvironmentInUseMarker，它指定环境标记的详细信息

属性

LabEnvironmentUri

环境的 URI。 使用 GetLabEnvironmentUri 活动可获取环境 URI。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

GetLabEnvironmentSnapshotId

获取环境快照的快照 ID。 如果未找到具有指定名称的快照，则此活动会引发 NoSnapshotFoundException 异常。

返回值

指定快照的标识符的 Int64。

属性

LabEnvironmentUri	环境的 URI。 使用 GetLabEnvironmentUri 活动可获取环境 URI。 必需。
SnapshotName	快照名称。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

GetLabEnvironmentStatus

获取环境的状态。

返回值

一个 LabEnvironmentState 枚举值，它指示环境的当前状态。

属性

LabEnvironmentUri

环境的 URI。 使用 GetLabEnvironmentUri 活动可获取环境 URI。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

GetLabEnvironmentUri

获取给定环境名称和实验室位置名称的环境 URI。 实验室位置可以是主机组或库共享。 如果未找到环境，则此活动会引发 LabEnvironmentNotFoundException 异常。

返回值

指定环境的 URI 的 String。

属性

LabEnvironmentName	环境名称。 必需。
ProjectName	团队项目的名称。 如果此属性值未指定或为 null，则使用生成的当前项目。
TeamProjectLabLocationName	实验室位置名称。 可以是主机组名称或库共享名称。 如果未找到实验室位置，则会引发 NoLabLocationFoundException 异常。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

InitializeAgentSpecAndEnvironmentVariables

初始化 RunDeploymentScript 活动所需的参数。 InitializeAgentSpecAndEnvironmentVariables 会提取环境中虚拟机的属性，这些属性是面向计算机上的部署脚本所必需的。

返回值

一个 ScriptDetails 对象，它存储部署所需的脚本详细信息。

属性

BuildLocation	生成位置路径。 此路径用于扩展宏 $(BuildLocation)。 必需。
DeploymentScriptDetails	部署详细信息的格式为“labsystemname | script arguments | working directory”。 必需。
LabEnvironmentUri	环境的 URI。 使用 GetLabEnvironmentUri 活动可获取环境 URI。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

ResetLabEnvironmentInuseMarker

重置环境的“正在使用”标记。

属性

LabEnvironmentUri

环境的 URI。 使用 GetLabEnvironmentUri 活动可获取环境 URI。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

RestoreLabEnvironment

将环境还原为指定快照。 如果快照无效，则此活动会引发 InvalidSnapshotException 异常。

属性

LabEnvironmentUri	环境的 URI。 使用 GetLabEnvironmentUri 活动可获取环境 URI。 必需。
SnapshotId	要将环境还原到的快照的 ID。 可通过使用 GetLabEnvironmentSnapshotId 活动来获取快照 ID。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

RunDeploymentScript

运行部署脚本。 如果脚本失败，则会引发或写入 ThrowOnError 属性中指定的一个生成警告。

返回值

一个 BuildStatus 枚举值，它指定部署操作的状态。

属性

MaximumAttemptsForNetUse	尝试添加 net use 的最大次数。
ScriptDetails	实验室系统的“脚本详细信息”对象。 必需。
SharedLocationForNetUse	实验室服务帐户应可访问的位置。
ThrowOnError	用于指示是否应在出错时引发异常的标记。 默认值为 True。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

RunWorkflow

在生成服务器的生成控制器上，对新工作流进行排队。 可通过两种方式指定必须在哪个生成控制器上对生成进行排队：

1. 使用 LabEnvironmentUri 属性。 如果为工作流集成配置此环境，则将使用环境的生成控制器对工作流进行排队。 否则，会引发 LabDeploymentProcessException。

2. 使用 BuildControler 属性来指定生成控制器。

返回值

一个 Int32，指定已排队生成的 ID。

属性

BuildController	生成控制器名称。 如果此属性和 LabEnvironmentUri 属性值为 null 或未指定，则使用当前生成控制器对生成进行排队。
BuildDefinition	要排队的生成定义。 必需。
LabEnvironmentUri	包含工作流功能的环境的 URI。 使用 GetLabEnvironmentUri 活动可获取环境 URI。 必需。
ProjectName	团队项目的名称。 如果此属性为 null 或未指定，则使用生成的当前项目。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

SaveLabEnvironment

创建一个新环境，然后将该环境存储到团队项目库共享中。 此活动会运行较长时间，并会一直等到保存该环境。 如果创建新环境失败，则会引发 LabDeploymentProcessException 异常。

返回值

指定新环境的 URL 的 String。

属性

LabEnvironmentName	已保存环境的名称。 如果此属性为 null 或为空，则将使用环境名称。
LabEnvironmentUri	要保存的环境的 URI。 使用 GetLabEnvironmentUri 活动可获取环境 URI。 必需。
TeamProjectLibraryShareName	存储环境的库共享。 如果未找到指定的库共享，则会引发 NoTeamProjectLibraryShareFoundException 异常。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

SetLabEnvironmentInuseMarker

设置环境的“正在使用”标记。

属性

注释	设置标记时写入的注释。
LabEnvironmentUri	环境的 URI。 使用 GetLabEnvironmentUri 活动可获取环境 URI。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

SnapshotLabEnvironment

拍摄环境的快照。 此活动会运行较长时间，并会一直等到创建环境快照。 如果创建快照失败，则此活动会引发 LabDeploymentProcessException 异常。

返回值

指定快照 ID 的 Int64。

属性

LabEnvironmentUri	必须为其拍摄快照的环境的 URI。 使用 GetLabEnvironmentUri 活动可获取环境 URI。 必需。
SnapshotChainId	返回快照链 ID。
SnapshotName	要拍摄的快照的名称。 如果此属性为 null，则将当前 DateTime 值用作快照名称。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

StartLabEnvironment

启动环境。 此活动会运行较长时间，并会一直等到启动该环境。 如果启动环境失败，则此活动会引发 LabDeploymentProcessException 异常。

属性

LabEnvironmentUri

环境的 URI。 使用 GetLabEnvironmentUri 活动可获取环境 URI。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

StopLabEnvironment

停止环境。 此活动会运行较长时间，并会一直等到停止该环境。 如果停止环境失败，则此活动会引发 LabDeploymentProcessException 异常。

属性

LabEnvironmentUri

环境的 URI。 使用 GetLabEnvironmentUri 活动可获取环境 URI。 必需。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

WaitForTestCapabilityServices

等待环境的测试功能准备就绪所需的指定最长时间。 如果测试功能在到达等待时间时未就绪，则会引发超时异常。 如果设置 RepairCapabilityBeforeWaitBegins 属性，则会先调用修复功能，然后等待该功能准备就绪。 可使用 MaxWaitTime 属性来配置最长等待时间。

属性

LabEnvironmentUri	环境的 URI。 使用 GetLabEnvironmentUri 活动可获取环境 URI。 必需。
MaxWaitTime	一个 System.TimeSpan 对象，它指定等待功能就绪的最长时间。 在到达指定持续时间时会引发超时异常。 默认值为 0（零），即表示无限期地等待。
RepairCapabilityBeforeWaitBegins	如果此值为 true，则会先尝试执行修复功能，然后等待。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

WaitForWorkflow

等待完成排队生成所需的给定最长时间。 如果生成工作流在给定的最长时间内未完成，则会引发超时异常。 活动会定期检查排队生成的状态以确定已完成哪些生成。 通过使用 RefreshInterval 属性配置此时间间隔。

返回值

一个 BuildStatus 枚举值，它指示工作流的状态。

属性

AllowPartiallySucceededBuild	如果为 true，则将部分成功视为成功。
BuildDetails	一个 Microsoft.TeamFoundation.Build.Client.IBuildDetail 对象，它包含生成服务器上已排队生成的详细信息。 这是一个 out 参数。
LabWorkflowType	工作流的类型。
MaxConsecutiveFailuresToIgnoreDuringWaitForCompletion	在等待工作流完成时，应忽略的最大连续失败次数。 此设置的默认值是 3。 可使用此属性增加工作流的可靠性。
MaxWaitTime	一个 System.TimeSpan 对象，它指定等待工作流完成的最长时间。 在到达指定持续时间时会引发超时异常。 默认值为 0（零），即表示无限期地等待。
QueueBuildId	已排队生成的 ID。 必需。
RefreshInterval	一个 System.TimeSpan 对象，它指定刷新工作流状态的时间间隔。 此间隔的默认值是 60 秒。
ThrowOnError	如果为 true，则在生成失败时会引发异常。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

WaitForWorkflowCapabilityServices

等待环境的工作流功能就绪的指定时间。 如果工作流功能在等待时间结束时未就绪，则会引发超时异常。 如果设置 RepairCapabilityBeforeWaitBegins 属性，则会先调用修复功能，然后等待功能准备就绪。 可使用 MaxWaitTime 属性来配置最长等待时间。

属性

LabEnvironmentUri	环境的 URI。 使用 GetLabEnvironmentUri 活动可获取环境 URI。 必需。
MaxWaitTime	一个 System.TimeSpan 对象，它指定等待功能就绪的最长时间。 在到达指定持续时间时会引发超时异常。 默认值为 0（零），即表示无限期地等待。
RepairCapabilityBeforeWaitBegins	如果此值为 true，则会先尝试执行修复功能，然后等待。
WaitForComputerNames	如果此值为 true，则一直等到环境的所有虚拟机的计算机名称可用。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

WriteDeploymentInformation

写入包含在生成摘要中的部署信息。 部署信息部分包含三个子部分：生成、部署和测试。 可使用 DeploymentInformationType 属性将部署信息添加到特定的子部分中。 可使用 Url 属性将链接添加到部署信息中。

属性

消息	要在摘要中显示的消息。 必需。
Url	要向消息中添加的可选 URL 或链接。
DeploymentInformationType	为此信息性消息指定部署信息的子部分。 使用下列值之一： Build 部署 Test

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

Lab Management 类

下表总结了可在工作流设计器中用来自定义生成、部署和测试过程的 Lab Management 类。 这些类是 Microsoft.TeamFoundation.Lab.Workflow.Activities 命名空间的一部分。

对象	说明
LabWorkflowDetails	LabWorkflowDetails 类包含实验室工作流参数向导中的配置数据。 LabWorkflowDetails 对象包含 BuildDetails、RunTestDetails 和 ScriptDetails 对象。
BuildDetails	存储生成、部署和测试方案的生成详细信息。
DeploymentDetails	存储在生成、部署和测试工作流中创建自动测试运行所需的测试参数详细信息
LabEnvironmentDetails	存储在生成、部署和测试方案中标识实验室环境所需的信息
LabEnvironmentInUseMarker	存储环境的“正在使用”标记的详细信息。
LabEnvironmentState	指定环境的当前状态。
RunTestDetails	存储创建自动测试运行所需的测试参数详细信息。
ScriptDetails	存储生成、部署和测试方案所需的部署脚本详细信息。
ScriptDetails	存储测试运行的详细信息。

LabWorkflowDetails

LabWorkflowDetails 类包含实验室工作流参数向导中的配置数据。 在 LabDefaultTemplate 中，工作流的 LabWorkflowDetails 对象包含在 LabWorkflowParameters 参数中。 LabWorkflowDetails 类包含以下属性：

BuildDetails	一个 BuildDetails 对象，它由工作流向导创建，并存储生成、部署和测试方案的生成详细信息。
DeploymentDetails	一个 LabEnvironmentDetails 对象，它由工作流向导创建，并存储在生成、部署和测试方案中部署生成所需的信息。
EnvironmentDetails	一个 LabEnvironmentDetails 对象，它由工作流向导创建，并存储标识用于生成、部署和测试方案的环境的信息。
TestParameters	一个 RunTestDetails 对象，它由工作流向导创建，并存储创建自动测试运行所需的测试参数详细信息。

BuildDetails

BuildDetails 存储生成、部署和测试方案的生成详细信息。

属性

IsTeamSystemBuild	一个 Boolean，它指示使用的生成是否是“团队生成”类型。
BuildDefinitionUri	指定生成定义的 URI 的 Uri。
BuildDefinitionName	指定生成定义的名称的 String。
QueueNewBuild	一个 Boolean，它指示是否必须对新生成进行排队。
BuildUri	一个 Uri，它指定生成的 URI（如果该生成是“团队生成”类型）。
CustomBuildPath	一个 String，它指定生成的路径（如果该生成不是“团队生成”类型）。
配置

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

DeploymentDetails

DeploymentDetails 存储在生成、部署和测试工作流中创建自动测试运行所需的测试参数详细信息。 可通过使用 LabWorkflowParameters Argument 参数的 DeploymentDetails 属性访问由 Lab Management 向导创建的 DeploymentDetails 对象。

属性

PostDeploymentSnapshotPath	一个 String，包含存储后期部署快照的路径。
PostDeploymentSnapshotName	一个 String，它指定部署后拍摄的快照的名称。
TakePostDeploymentSnapshot	一个 Boolean，它指定是否需要后期部署快照。
脚本	一个 StringList 对象，它包含虚拟机及其相应部署脚本的列表。
DeploymentNeeded	一个 Boolean，它指定是否需要执行部署。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

LabEnvironmentDetails

一个 LabEnvironmentDetails，它存储在生成、部署和测试方案中标识实验室环境所需的信息。 可通过使用 LabWorkflowParameters Argument 参数的 EnvironmentDetails 属性访问由 Lab Management 工作流向导创建的 LabEnvironmentDetails 对象。

属性

ProjectName	一个 String，它指定团队项目的名称
LabEnvironmentName	一个 String，它指定实验室环境的名称
NewLabEnvironmentName	一个 String，它指定要创建的实验室环境的名称。
HostGroupName	一个 String，它指定要将环境部署到的主机组的名称。
LabLibraryShareName	一个 String，它指定包含存储的实验室环境模板的库共享的名称。
RevertToSnapshot	一个 Boolean，指示是否应将环境回滚到快照。
SnapshotName	一个 String，它指定要回滚到的环境快照的名称。
TfsUrl	一个 String，它指定 Team Foundation Server 的 URL。
LabEnvironmentUri	一个 Uri，它指定选定环境的 URI。
Disposition	LabEnvironmentDisposition 枚举的指示环境的状态的值。 该属性的值有： 未知 - 环境的状态未知。 活动 - 已在主机上部署环境，并且可启动并运行环境。 已存储 - 已将环境存储到库共享中，并且在部署前无法使用环境。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

RunTestDetails

RunTestDetails 存储在生成、部署和测试工作流中创建自动测试运行所需的测试参数详细信息。 可通过使用 LabWorkflowParameters Argument 参数的 TestParameters 属性访问由 Lab Management 向导创建的 RunTestDetails 对象。

属性

TfsUrl	一个 String，它指定 Team Foundation Server 的 URL。
项目名称	一个 String，它指定团队项目的名称。
TestConfigurationId	一个 Int32，它指定测试运行的测试配置的 ID。
TestPlanId	一个 Int32，它指定测试计划的 ID。
TestSuiteIdList	一个 Systems.Collections.Generic.List<int>，它包含要运行的测试套件的数字 ID。
TestSettingsId	一个 Int32，它指定测试运行的测试设置的 ID。
RunTest	一个 Boolean，它指定是否运行测试。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

ScriptDetails

提供脚本部署的详细信息。 在将 RunDeploymentScript 活动添加到工作流设计器中时，需要 ScriptDetails 对象。 InitializeAgentSpecAndEnvironmentVariables 返回一个 ScriptDetails 对象。

属性

LabSystemName	一个 String，它指定实验室环境的名称。
AgentSpec	一个 AgentReservationSpec 对象，它包含与实验室系统中的生成代理关联的标记。
FileName	一个 String，它指定部署脚本文件的名称。
参数	一个 String，它指定要传递到部署脚本的参数。
WorkingDirectory	一个 String，它指定实验室系统上的部署脚本的工作目录。
EnvironmentVariables	一个 System.Collection.Generic.IDictionary<String,String>，它包含环境变量名称/值对。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

TestRunStatistics

存储测试运行的详细信息。 ExecuteRemoteTestRun 活动将返回一个 TestRunStatistics 对象。

属性

TotalTests	一个 Int32，它指定测试运行中测试的总数。
PassedTests	一个 Int32，它指定传入测试运行中的测试的数量。
FailedTests	指定number " Int32 测试失败的执行。
InconclusiveTests	指定number " Int32 测试是无结论的测试运行中的测试。
PendingTests	一个 Int32，它指定测试运行中尚未运行的测试的数量。
AbortedTests	指定number " Int32 测试在测试会中止。
InProgressTests	一个 Int32，它指定测试运行中当前正在运行的测试的数量。
TestRunStatus	一个 TestRunState 枚举值，它指定测试运行的状态。
TestRunId	一个 Int32，它指定测试运行的标识符。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

LabEnvironmentInUseMarker

存储环境的“正在使用”标记的详细信息。 使用 GetLabEnvironmentInUseMarker 活动可返回一个 LabEnvironmentInUseMarker 对象。

属性

用户	一个 String，它指定标记环境的用户。
时间戳	一个 DateTime，它指定用户标记环境的时间。
注释	一个由标记环境的用户指定的 String。

b3f645d4-2db0-40e7-b8bf-eedca5d82ba8#BKMK_Top

LabEnvironmentState

指定环境的当前状态的枚举。 实验室环境的状态大多数由其包含的虚拟机的状态确定。 如果所有虚拟机都处于一致的稳定状态，则 LabEnvironmentState 值会与该状态匹配。 否则，此值为 Mixed 或 Failed。 当对环境执行的操作正在进行时，实验室环境处于转换状态，指示正在进行的操作。

LabEnvironmentState 包含以下值：

未知

Creating

CreateFailed

CreateCancelling

Updating

已存储

Starting

Running

Pausing

Paused

Stopping

Stopped

CreatingSnapshot

DeletingSnapshot

RestoringSnapshot

删除

DeleteFailed

Deleted

Mixed

未通过

UnderMigration

请参见

概念

LabDefaultTemplate 工作流活动