DeployVisualStudioTestAgent@2 - Visual Studio 測試代理程式部署 v2 工作

重要

此工作已被取代，且將于 2024 年 1 月 31 日淘汰。 使用 Visual Studio 測試工作 來執行單元和功能測試。

Syntax

# Visual Studio test agent deployment v2
# DeployVisualStudioTestAgent@2 is deprecated. Use the Visual Studio Test task to run unit and functional tests.
- task: DeployVisualStudioTestAgent@2
  inputs:
  # Test Machines
    testMachines: # string. Required. Machines. 
    adminUserName: # string. Required. Admin login. 
    adminPassword: # string. Required. Admin password. 
    winRmProtocol: 'Http' # 'Http' | 'Https'. Required. Protocol. Default: Http.
    #testCertificate: true # boolean. Optional. Use when winRmProtocol = Https. Test Certificate. Default: true.
  # Agent Configuration
    machineUserName: # string. Required. Username. 
    machinePassword: # string. Required. Password. 
    #runAsProcess: false # boolean. Run UI tests. Default: false.
    #isDataCollectionOnly: false # boolean. Enable data collection only. Default: false.
  # Advanced
    #testPlatform: '14.0' # '15.0' | '14.0'. Test agent version. Default: 14.0.
    #agentLocation: # string. Test agent location. 
    #updateTestAgent: false # boolean. Update test agent. Default: false.

輸入

testMachines - 機器
string. 必要。

此輸入有三個選項：

• 提供以逗號分隔的電腦 IP 位址或 FQDN 清單以及埠。 預設埠是以選取的通訊協定為基礎。 例如： dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986 。
• 提供其他工作的輸出變數。 例如： $(variableName) 。
• 提供電腦群組名。 如果您使用 HTTPS，電腦的名稱/IP 應該符合憑證上的 CN。

adminUserName - 管理員登入
string. 必要。

指定目的電腦的系統管理員登入。

adminPassword - 管理員密碼
string. 必要。

指定目的電腦的系統管理員密碼。 此輸入可以接受建置/發行定義中所定義的變數作為 $(passwordVariable) 。 您可以將變數類型標示為 secret 來保護它。

winRmProtocol - 協定
string. 必要。 允許值：Http 和 Https。 預設值：Http。

指定要用於與電腦 () 之 WinRM 連線的通訊協定。 預設值是 HTTPS。

testCertificate - 測試憑證
boolean. 選擇性。 使用 時 winRmProtocol = Https 。 預設值：true。

提供選項，以略過受信任憑證授權單位單位機器憑證的真實性驗證。 WinRM HTTPS 通訊協定需要 參數。

machineUserName - 使用者
string. 必要。

指定測試代理程式需要執行的使用者名稱。

machinePassword - 密碼
string. 必要。

指定上述使用者名稱的密碼。

runAsProcess - 執行 UI 測試
boolean. 預設值：false。

表示測試代理程式是否需要以互動式程式執行。 自動程式化 UI 測試需要此輸入。

isDataCollectionOnly - 僅啟用資料收集
boolean. 預設值：false。

選擇性。 指定測試代理程式是否僅用於資料收集，而不是用於執行測試。 這通常可在測試 (AUT) 電腦群組下的應用程式上找到。

testPlatform - 測試代理程式版本
string. 允許的值： 15.0 (Visual Studio 2017) ， 14.0 (Visual Studio 2015) 。 預設值：14.0。

指定 Visual Studio 測試代理程式的版本。 選擇適當的版本，以使用所建置的測試二進位檔來比對 VS 版本。

agentLocation - 測試代理程式位置
string.

選擇性。 提供從網路或本機位置 vstf_testagent.exe 的路徑。 如果未提供路徑，系統會自動從 下載中心下載。 安裝測試代理程式 2015 Update 3。
安裝測試代理程式 2017。

updateTestAgent - 更新測試代理程式
boolean. 預設值：false。

如果測試代理程式已在機器上部署，此選項會檢查該版本是否有可用的更新。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制選項和一般工作屬性。

輸出變數

無。

備註

此工作版本的新功能：

• 支援 Visual Studio Test Agent 2017：您現在可以使用多個版本的 Visual Studio 測試代理程式來部署和執行測試。 支援版本 2015 和 2017。
• 不再支援從測試中樞建立的電腦群組。 您可以繼續使用機器或 Azure 資源群組的清單。

規格需求

需求	描述
管線類型	YAML、傳統組建、傳統版本
在 上執行	代理程式
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任何
可設定變數	任何
代理程式版本	2.0.0 或更新版本
工作類別	測試