Lab Management 工作流程活動

當您自訂 Lab Management 工作流程範本 (LabDefaultTemplate.11.xaml) 時，可以使用其中一個或多個預先定義的 Lab Management 活動。 您也可以存取 Lab Management 精靈所建立的物件。 本主題描述自訂工作流程範本以建置、部署以及測試您應用程式時可用的 Team Foundation Lab Management 活動和物件。 如需如何在自訂的工作流程中使用這些活動的詳細資訊，請參閱自訂 Lab Management 工作流程。

需求

• Visual Studio Ultimate, Visual Studio Premium, Visual Studio Test Professional

此主題包括下列章節：

1. Lab Management Activities

2. Lab Management Classes

Lab Management 活動

下表描述個別的 Lab Management 工作流程活動。

活動	描述
CreateLabEnvironment	從預存範本建立新環境，然後在指定的主機群組上進行部署。
DeleteLabEnvironment	刪除環境。
DeleteSnapshot	刪除環境的快照。
ExecuteRemoteTestRun	建立在環境上執行的測試，並等待其完成。
GenerateEnvironmentViewerFile	產生擁有快照連結 ID 的環境檢視器檔案。 此檔案用來連接至環境的快照。
GetBuildLocationAndBuildNumber	傳回組建、部署與測試情節的組建位置和組建編號。
GetLabEnvironmentInUseMarker	傳回環境的使用中標記。
GetLabEnvironmentSnapshotId	取得環境快照的 ID。
GetLabEnvironmentStatus	取得環境狀態。
GetLabEnvironmentUri	取得指定環境名稱和實驗室位置名稱的環境 URI。
InitializeAgentSpecAndEnvironmentVariables	剖析屬性所指定的部署指令碼詳細資料
ResetLabEnvironmentInuseMarker	重設環境的使用中標記。
RestoreLabEnvironment	將環境還原至指定的快照。
RunDeploymentScript	執行部署指令碼。 失敗時，擲回或寫入組建警告，如 ThrowOnError 屬性中所指定。
RunWorkflow	在組建伺服器的組建控制器上佇列新的工作流程。
SaveLabEnvironment	建立新環境，然後將其儲存在 Team 專案程式庫共用中。
SetLabEnvironmentInuseMarker	設定環境的使用中標記。
SnapshotLabEnvironment	擷取環境的快照。
StartLabEnvironment	啟動環境。
StopLabEnvironment	停止環境。
WaitForTestCapabilityServices	等待指定的時間上限，讓環境的測試功能準備就緒。 等待時間結束時，如果測試功能還未準備就緒，就會擲回逾時例外狀況。
WaitForWorkflow	工作流程的類型。
WaitForWorkflowCapabilityServices	等待指定的等待時間上限，讓佇列的組建完成。 如果組建工作流程沒有在指定的時間上限內完成，就會擲回 TimeOutException。 活動會定期檢查佇列的組建狀態以判斷完成的組建。 您可以使用 RefreshInterval 屬性設定這個間隔。
WriteDeploymentInformation	寫入組建摘要中所包含的部署資訊。

CreateLabEnvironment

從預存範本建立新環境，然後在指定的主機群組上進行部署。 這是長時間執行的活動，而且會等到建立新環境為止。 如果無法建立新的實驗室環境，此活動會擲回一個 LabDeploymentProcessException 例外狀況。

屬性

LabEnvironmentName	新環境的名稱。 如果此屬性為 null 或空白，將會使用環境範本名稱。
LabEnvironmentTemplateUri	預存環境範本的 URI。 您可以使用 GetLabEnvironmentUri 活動取得實驗室環境範本 URI。 必要項。
TeamProjectHostGroupName	將部署新環境所在的主機群組。 如果找不到具指定的主機群組，則會擲回 NoTeamProjectHostGroupFoundException 例外狀況。 必要項。

Back to top

DeleteLabEnvironment

刪除環境。 這是長時間執行的活動，而且會等到刪除環境為止。 如果環境刪除失敗，此活動會擲回一個 LabDeploymentProcessException 例外狀況。

屬性

LabEnvironmentUri

要刪除之環境的 URI。 您可以使用 GetLabEnvironmentUri 活動取得實驗室環境 URI。 必要項。

Back to top

DeleteSnapshot

刪除環境的快照。 這是長時間執行的活動，而且會等待刪除快照。 如果快照刪除失敗，此活動會擲回一個 LabDeploymentProcessException 例外狀況。

屬性

LabEnvironmentUri	更新其快照之實驗室環境的 URI。 您可以使用 GetLabEnvironmentUri 活動取得實驗室環境 URI。 必要項。
SnapshotId	要刪除之快照的 ID。 您可以使用 GetLabEnvironmentSnapshotId 活動取得快照 ID。 必要項。

Back to 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	Microsoft.TeamFoundation.Lab.Workflow.Activities.RunTestDetails 物件會指定測試參數，例如測試計劃、測試套件、測試設定以及測試組態。 必要項。
標題	測試回合的名稱。 必要項。

Back to top

GenerateEnvironmentViewerFile

產生包含快照連結 ID 的環境檢視器檔案。 此活動用來連接至環境的快照。 環境檢視器檔案的名稱就是不含下列任何特殊字元的快照名稱：@"[`~!@#$%^&*()+=[{\]}|\\;:',/?]"+ "\""。

屬性

FilePath	儲存環境檢視器檔案所在的 UNC 路徑。 組建服務帳戶必須具有路徑的寫入權限。 必要項。
LabEnvironmentUri	環境的 URI。 您可以使用 GetLabEnvironmentUri 活動取得環境 URI。 必要項。
SnapshotId	快照的 ID。 您可以使用 GetLabEnvironmentSnapshotId 活動取得快照 ID。 如果快照無效，則會擲回 InvalidSnapshotException 例外狀況。 必要項。

Back to top

GetBuildLocationAndBuildNumber

傳回組建、部署與測試情節的組建位置和組建編號。 如果選取 "Team Build"，而且組建的 URI 為 null，則會選取最後一個良好的組建，並傳回詳細資料。 如果找不到最後一個良好的組建，就會擲回 System.ArgumentException。 如果未選取 "Team Build"，則只會傳回使用者所指定的組建位置。

傳回值

指定組建位置的 String。

屬性

BuildDetails	Microsoft.TeamFoundation.Lab.Workflow.Activities.BuildDetails 物件，其中包含組建、部署和測試情節中與組建相關的資訊。
BuildNumber	所選組建的組建編號。 這是一個 outArgument。 對於非 "Team Build" 組建而言，這是 null。
SelectedBuild	有關組建伺服器的組建資訊。 這是一個 outArgument。 對於非 "Team Build" 組建而言，這是 null。

Back to top

GetLabEnvironmentInUseMarker

取得環境的使用中標記。

傳回值

LabEnvironmentInUseMarker 可指定環境標記的詳細資料

屬性

LabEnvironmentUri

環境的 URI。 使用 GetLabEnvironmentUri 活動取得環境 URI。 必要項。

Back to top

GetLabEnvironmentSnapshotId

取得環境快照的快照 ID。 如果找不到具有指定之名稱的快照，此活動會擲回一個 NoSnapshotFoundException 例外狀況。

傳回值

指定快照識別碼的 Int64。

屬性

LabEnvironmentUri	環境的 URI。 使用 GetLabEnvironmentUri 活動取得環境 URI。 必要項。
SnapshotName	快照名稱。 必要項。

Back to top

GetLabEnvironmentStatus

取得環境的狀態。

傳回值

表示目前環境狀態的 LabEnvironmentState 列舉值。

屬性

LabEnvironmentUri

環境的 URI。 使用 GetLabEnvironmentUri 活動取得環境 URI。 必要項。

Back to top

GetLabEnvironmentUri

取得指定環境名稱和實驗室位置名稱的環境 URI。 實驗室位置可以是主機群組或程式庫共用。 如果找不到環境，此活動會擲回 LabEnvironmentNotFoundException 例外狀況。

傳回值

指定環境 URI 的 String。

屬性

LabEnvironmentName	環境名稱。 必要項。
ProjectName	Team 專案的名稱。 如果此屬性值為 null 或未指定，則會使用組建的目前專案。
TeamProjectLabLocationName	實驗室名稱。 可以是主機群組名稱或程式庫共用名稱。 如果找不到實驗室位置，則會擲回一個 NoLabLocationFoundException 例外狀況。 必要項。

Back to top

InitializeAgentSpecAndEnvironmentVariables

初始化 RunDeploymentScript 活動所需的引數。 InitializeAgentSpecAndEnvironmentVariables 會擷取環境中虛擬機器的屬性，這些屬性是在機器上設定部署指令碼目標所必須。

傳回值

ScriptDetails 物件會儲存部署所需的指令碼詳細資料。

屬性

BuildLocation	組建位置路徑。 這用來擴充巨集 $(BuildLocation)。 必要項。
DeploymentScriptDetails	「實驗室系統名稱 | 指令碼引數 |工作目錄」格式的部署詳細資料。 必要項。
LabEnvironmentUri	環境的 URI。 使用 GetLabEnvironmentUri 活動取得環境 URI。 必要項。

Back to top

ResetLabEnvironmentInuseMarker

重設環境的使用中標記。

屬性

LabEnvironmentUri

環境的 URI。 使用 GetLabEnvironmentUri 活動取得環境 URI。 必要項。

Back to top

RestoreLabEnvironment

將環境還原至指定的快照。 如果快照無效，此活動會擲回 InvalidSnapshotException 例外狀況。

屬性

LabEnvironmentUri	環境的 URI。 使用 GetLabEnvironmentUri 活動取得環境 URI。 必要項。
SnapshotId	在其中還原環境之快照的 ID。 您可以使用 GetLabEnvironmentSnapshotId 活動取得快照 ID。 必要項。

Back to top

RunDeploymentScript

執行部署指令碼。 如果指令碼失敗，擲回或寫入組建警告，如 ThrowOnError 屬性中所指定。

傳回值

指定部署作業狀態的 BuildStatus 列舉值。

屬性

MaximumAttemptsForNetUse	要加入網路使用的嘗試次數上限。
ScriptDetails	實驗室系統的 Script Details 物件。 必要項。
SharedLocationForNetUse	應由實驗室服務帳戶所存取的位置。
ThrowOnError	表示是否為錯誤擲回例外狀況的旗標。 預設值為 True。

Back to top

RunWorkflow

在組建伺服器的組建控制器上佇列新的工作流程。 有兩種方式可以指定必須佇列組建所在的組建控制器：

1. 使用 LabEnvironmentUri 屬性。 如果此環境是針對工作流程整合所設定，將會使用其環境的組建控制器來佇列工作流程。 否則會擲回 LabDeploymentProcessException。

2. 使用 BuildControler 屬性指定組建控制器。

傳回值

指定佇列之組建 ID 的 Int32。

屬性

BuildController	組建控制器名稱。 如果此屬性和 LabEnvironmentUri 屬性值為 null 或未指定，就會使用目前的組建控制器來佇列組建。
BuildDefinition	要佇列的組建定義。 必要項。
LabEnvironmentUri	具有工作流程功能之環境的 URI。 使用 GetLabEnvironmentUri 活動取得環境 URI。 必要項。
ProjectName	Team 專案的名稱。 如果此屬性為 null 或未指定，則會使用組建的目前專案。

Back to top

SaveLabEnvironment

建立新環境，然後將其儲存在 Team 專案程式庫共用中。 這是長時間執行的活動，而且會等到儲存環境為止。 如果建立新環境失敗，此活動會擲回一個 LabDeploymentProcessException 例外狀況。

傳回值

指定新環境 URI 的 String。

屬性

LabEnvironmentName	已儲存之環境的名稱。 如果此屬性為 null 或空白，將會使用環境名稱。
LabEnvironmentUri	要儲存之環境的 URI。 使用 GetLabEnvironmentUri 活動取得環境的 URI。 必要項。
TeamProjectLibraryShareName	要將環境儲存在其中的程式庫共用。 如果找不到具指定的程式庫共用，則會擲回 NoTeamProjectLibraryShareFoundException 例外狀況。 必要項。

Back to top

SetLabEnvironmentInuseMarker

設定環境的使用中標記。

屬性

Comment	設定標記時寫入的註解。
LabEnvironmentUri	環境的 URI。 使用 GetLabEnvironmentUri 活動取得環境 URI。 必要項。

Back to top

SnapshotLabEnvironment

擷取環境的快照。 這是長時間執行的活動，而且會等到建立環境的快照為止。 如果建立快照失敗，此活動會擲回一個 LabDeploymentProcessException 例外狀況。

傳回值

指定快照 ID 的 Int64。

屬性

LabEnvironmentUri	必須拍攝其快照之環境的 URI。 使用 GetLabEnvironmentUri 活動取得環境 URI。 必要項。
SnapshotChainId	傳回快照鏈結 ID。
SnapshotName	要拍攝之快照的名稱。 如果此屬性為 null，則會使用目前的 DateTime 值做為快照名稱。

Back to top

StartLabEnvironment

啟動環境。 這是長時間執行的活動，而且會等到環境啟動為止。 如果啟動環境失敗，此活動會擲回一個 LabDeploymentProcessException 例外狀況。

屬性

LabEnvironmentUri

環境的 URI。 使用 GetLabEnvironmentUri 活動取得環境 URI。 必要項。

Back to top

StopLabEnvironment

停止環境。 這是長時間執行的活動，而且會等到環境停止為止。 如果停止環境失敗，此活動會擲回一個 LabDeploymentProcessException 例外狀況。

屬性

LabEnvironmentUri

環境的 URI。 使用 GetLabEnvironmentUri 活動取得環境 URI。 必要項。

Back to top

WaitForTestCapabilityServices

等待指定的時間上限，讓環境的測試功能準備就緒。 如果在等待時間結束時，測試功能還未準備就緒，就會擲回逾時例外狀況。 如果已設定 RepairCapabilityBeforeWaitBegins 屬性，在等待功能準備就緒之前，就會叫用修復功能。 您可以使用 MaxWaitTime 屬性設定等待時間上限。

屬性

LabEnvironmentUri	環境的 URI。 使用 GetLabEnvironmentUri 活動取得環境 URI。 必要項。
MaxWaitTime	System.TimeSpan 物件，這個物件會指定等待功能準備就緒的時間上限。 在指定的逾時期間結束時，會擲回逾時例外狀況。 預設值為 0 (零)，表示永遠等待。
RepairCapabilityBeforeWaitBegins	如果此值為 true，就會在等待前完成修復功能的嘗試。

Back to top

WaitForWorkflow

等待指定的等待時間上限，讓佇列的組建完成。 如果組建工作流程沒有在指定的時間上限內完成，就會擲回 TimeOut Exception。 活動會定期檢查佇列的組建狀態以判斷完成的組建。 您可以使用 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，則會在組建失敗時擲回例外狀況。

Back to top

WaitForWorkflowCapabilityServices

等待指定的時間，讓環境的工作流程功能準備就緒。 如果在等待時間結束時，工作流程功能還未準備就緒，就會擲回逾時例外狀況。 如果已設定 RepairCapabilityBeforeWaitBegins 屬性，在等待功能準備就緒之前，就會叫用修復功能。 您可以使用 MaxWaitTime 屬性設定等待時間上限。

屬性

LabEnvironmentUri	環境的 URI。 使用 GetLabEnvironmentUri 活動取得環境 URI。 必要項。
MaxWaitTime	System.TimeSpan 物件，這個物件會指定等待功能準備就緒的時間上限。 在指定的逾時期間結束時，會擲回逾時例外狀況。 預設值為 0 (零)，表示永遠等待。
RepairCapabilityBeforeWaitBegins	如果此值為 true，就會在等待前完成修復功能的嘗試。
WaitForComputerNames	如果此值為 true，請等到環境之所有虛擬機器的電腦名稱可用為止。

Back to top

WriteDeploymentInformation

寫入組建摘要中所包含的部署資訊。 部署資訊區段有三個子區段：組建、部署和測試。 您可以使用 DeploymentInformationType 屬性，將部署資訊加入至特定子區段中。 您可以使用 Url 屬性，將連結加入至部署資訊。

屬性

訊息	要顯示在摘要中的訊息。 必要項。
URL	要加入至訊息的選用 URL 或連結。
DeploymentInformationType	指定此資訊訊息之部署資訊的子區段。 使用下列其中一個值： 組建 部署 測試

Back to top

Lab Management 類別

下表摘要說明您可以在工作流程設計工具中，用於自訂組建、部署和測試流程的 Lab Management 類別。 這些類別是 Microsoft.TeamFoundation.Lab.Workflow.Activities 命名空間的一部分。

物件	描述
LabWorkflowDetails	LabWorkflowDetails 類別包含來自「實驗室工作流程參數」精靈的組態資料。 LabWorkflowDetails 物件包含 BuildDetails、RunTestDetails 與 ScriptDetails 物件。
BuildDetails	儲存組建、部署與測試情節的組建詳細資料。
DeploymentDetails	儲存在組建、部署和測試工作流程中建立自動化的測試回合所需的測試參數詳細資料。
LabEnvironmentDetails	儲存在組建、部署和測試情節中識別實驗室環境所需的資訊
LabEnvironmentInUseMarker	儲存環境之使用中標記的詳細資料。
LabEnvironmentState	指定環境的目前狀態。
RunTestDetails	儲存建立自動化的測試回合所需的測試參數詳細資料。
ScriptDetails	儲存組建、部署和測試情節所需的部署指令碼詳細資料。
TestRunStatistics	儲存測試回合的詳細資料。

LabWorkflowDetails

LabWorkflowDetails 類別包含來自「實驗室工作流程參數」精靈的組態資料。 在 LabDefaultTemplate 中，工作流程的 LabWorkflowDetails 物件包含在 LabWorkflowParameters 引數中。 LabWorkflowDetails 類別包含下列屬性：

BuildDetails	Microsoft.TeamFoundation.Lab.Workflow.Activities.BuildDetails 物件由工作流程精靈所建立，並且會儲存組建、部署和測試情節的組建詳細資料。
DeploymentDetails	Microsoft.TeamFoundation.Lab.Workflow.Activities.DeploymentDetails 物件由工作流程精靈所建立，並且會儲存在組建、部署和測試情節中部署組建所需的資訊。
EnvironmentDetails	Microsoft.TeamFoundation.Lab.Workflow.Activities.LabEnvironmentDetails 物件由工作流程精靈所建立，並且會將識別建置、部署和測試情節所使用之環境的資訊加以儲存。
TestParameters	Microsoft.TeamFoundation.Lab.Workflow.Activities.RunTestDetails 物件由工作流程精靈所建立，並且會儲存建立自動化的測試回合所需的測試參數詳細資料。

BuildDetails

BuildDetails 會儲存組建、部署與測試情節的組建詳細資料。

屬性

IsTeamSystemBuild	指出使用的組建是否為 Team Build 類型的 Boolean。
BuildDefinitionUri	指定組建定義 URI 的 Uri。
BuildDefinitionName	指定組建定義名稱的 String。
QueueNewBuild	指出是否必須佇列新組建的 Boolean。
BuildUri	指定組建為 Team Build 類型時，組建 URI 的 Uri。
CustomBuildPath	指定組建不是 Team Build 類型時，組建路徑的 String。
組態

Back to top

DeploymentDetails

DeploymentDetails 會儲存在組建、部署和測試工作流程中建立自動化的測試回合所需的測試參數詳細資料。 使用 LabWorkflowParameters 引數的 DeploymentDetails 屬性，您就可以存取 Lab Management 精靈所建立的 DeploymentDetails 物件。

屬性

PostDeploymentSnapshotPath	包含儲存部署後快照路徑的 String。
PostDeploymentSnapshotName	指定部署後拍攝之快照名稱的 String。
TakePostDeploymentSnapshot	指定是否需要部署後快照的 Boolean。
Scripts	包含虛擬機器及對應部署指令碼之清單的 StringList 物件。
DeploymentNeeded	指定是否需要完成部署的 Boolean。

Back to top

LabEnvironmentDetails

LabEnvironmentDetails 會儲存在組建、部署和測試情節中識別實驗室環境所需的資訊。 使用 LabWorkflowParameters 引數的 EnvironmentDetails 屬性，您就可以存取 Lab Management 工作流程精靈所建立的 LabEnvironmentDetails 物件。

屬性

ProjectName	指定 Team 專案名稱的 String
LabEnvironmentName	指定實驗室環境名稱的 String
NewLabEnvironmentName	指定要建立之實驗室環境名稱的 String。
HostGroupName	指定部署環境之主機群組名稱的 String。
LabLibraryShareName	指定包含預存實驗室環境範本之程式庫共用名稱的 String。
RevertToSnapshot	表示是否應該將環境復原至快照的 Boolean。
SnapshotName	指定要在其中復原之環境快照名稱的 String。
TfsUrl	指定 Team Foundation Server 之 URL 的 String。
LabEnvironmentUri	指定所選環境 URI 的 Uri。
Disposition	表示環境狀態的 LabEnvironmentDisposition 列舉值。 這些值包括： Unknown - 環境的狀態未知。 Active - 環境部署在主機上，而且可以啟動並執行。 Stored - 環境已儲存在程式庫共用中，而且在進行部署前無法使用。

Back to top

RunTestDetails

RunTestDetails 會儲存在組建、部署和測試工作流程中建立自動化的測試回合所需的測試參數詳細資料。 使用 LabWorkflowParameters 引數的 TestParameters 屬性，您就可以存取 Lab Management 精靈所建立的 RunTestDetails 物件。

屬性

TfsUrl	指定 Team Foundation Server 之 URL 的 String。
Project name	指定 Team 專案名稱的 String。
TestConfigurationId	Int32 物件，這個物件會指定測試回合之測試組態的 ID。
TestPlanId	指定測試計劃 ID 的 Int32。
TestSuiteIdList	包含要執行之測試套件數字 ID 的 Systems.Collections.Generic.List<int>
TestSettingsId	Int32 物件，這個物件會指定測試回合之測試設定的 ID。
RunTest	指定是否要執行測試的 Boolean。

Back to top

ScriptDetails

提供部署指令碼的詳細資料。 當您將 RunDeploymentScript 活動加入工作流程設計工具時，需要 ScriptDetails 物件。 InitializeAgentSpecAndEnvironmentVariables 會傳回 ScriptDetails 物件。

屬性

LabSystemName	指定實驗室環境名稱的 String。
AgentSpec	AgentReservationSpec 物件，其中包含與實驗室系統中組建代理程式相關聯的標記。
FileName	指定部署指令碼檔案名稱的 String。
引數	指定要傳遞到部署指令碼之引數的 String。
WorkingDirectory	指定實驗室系統上部署指令碼之工作目錄的 String。
EnvironmentVariables	包含環境變數名稱/值組的 System.Collection.Generic.IDictionary<String,String>。

Back to top

TestRunStatistics

儲存測試回合的詳細資料。 ExecuteRemoteTestRun 活動會傳回 TestRunStatistics 物件。

屬性

TotalTests	在測試回合中指定測試總數的 Int32。
PassedTests	指定在測試回合中傳遞之測試數目的 Int32。
FailedTests	指定在測試回合中失敗之測試數目的 Int32。
InconclusiveTests	指定在測試回合中結果不明之測試數目的 Int32。
PendingTests	指定在測試回合中尚未執行之測試數目的 Int32。
AbortedTests	指定已在測試回合中止之測試數目的 Int32。
InProgressTests	指定所擁有之測試數目目前在測試回合中執行的 Int32。
TestRunStatus	指定測試回合狀態的 TestRunState 列舉值。
TestRunId	指定測試回合識別碼的 Int32。

Back to top

LabEnvironmentInUseMarker

儲存環境之使用中標記的詳細資料。 使用 GetLabEnvironmentInUseMarker 活動傳回 LabEnvironmentInUseMarker 物件。

屬性

User	指定標示環境之使用者的 String。
Timestamp	指定使用者標示環境之時間的 DateTime。
Comment	標示環境之使用者指定的 String。

Back to top

LabEnvironmentState

指定環境目前狀態的列舉。 實驗室環境的狀態大部分取決於所包含之虛擬機器的狀態。 如果所有虛擬機器均處於一致的穩定狀態，LabEnvironmentState 值就會符合該狀態。 否則，此值為 Mixed 或 Failed。 作業正在環境中進行時，實驗室環境會處於轉換狀態，表示進行中的作業。

LabEnvironmentState 擁有下列值：

未知

Creating

CreateFailed

CreateCancelling

Updating

Stored

Starting

正在執行

Pausing

Paused

Stopping

已停止

CreatingSnapshot

DeletingSnapshot

RestoringSnapshot

Deleting

DeleteFailed

Deleted

Mixed

失敗

UnderMigration

請參閱

概念

LabDefaultTemplate 工作流程活動