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

要求

要求 说明
管道类型 YAML,经典版本,经典版本
运行时间 代理人
需求 没有
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任何
Settable 变量 任何
代理版本 2.0.0 或更高版本
任务类别 测试