共用方式為


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

這很重要

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

這很重要

DeployVisualStudioTestAgent@2已被取代。 使用 Visual Studio 測試工作 來執行單元和功能測試。

語法

# 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。 必須的。 允許的值:HttpHttps。 預設值:Http

指定要用於與機器之 WinRM 連線的通訊協定。 預設值是 HTTPS


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

提供選項,讓受信任的證書頒發機構單位略過機器憑證的真實性驗證。 WinRM HTTPS 通訊協定需要 參數。


machineUserName - Username
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 Test Agent 來部署和執行測試。 支援版本 2015 和 2017。
  • 不再支援從測試中樞建立的計算機群組。 您可以繼續使用電腦或 Azure 資源群組的清單。

需求

要求 說明
管線類型 YAML、傳統組建、傳統版本
執行於 代理
需求 沒有
功能 此工作不符合作業中後續工作的任何需求。
命令限制 任意
Settable 變數 任意
代理程式版本 2.0.0 或更新
工作類別 測試