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.
# 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 - 用户
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 的路径。 如果未提供路径,则会自动从 下载中心下载该路径安装 Test Agent 2015 Update 3
安装测试代理 2017


updateTestAgent - 更新测试代理
boolean. 默认值:false

如果测试代理已部署在计算机上,此选项将检查是否有可用于该版本的更新。


任务控制选项

除了任务输入,所有任务都有控制选项。 有关详细信息,请参阅 控制选项和常见任务属性

输出变量

无。

备注

此任务版本中的新增功能:

  • 支持 Visual Studio 测试代理 2017:现在可以使用多个版本的 Visual Studio 测试代理来部署和运行测试。 支持版本 2015 和 2017。
  • 不再支持从测试中心创建的计算机组。 可以继续使用计算机列表或 Azure 资源组。

要求

要求 说明
管道类型 YAML、经典版本、经典版本
运行平台 Agent
需求
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置变量 任意
代理版本 2.0.0 或更高版本
任务类别 测试