DeployVisualStudioTestAgent@2: tarea de implementación del agente de prueba de Visual Studio v2

Artículo
03/24/2025

Importante

Esta tarea está en desuso y se retirará el 31 de enero de 2024. Use la tarea prueba de Visual Studio para ejecutar pruebas unitarias y funcionales.

Importante

DeployVisualStudioTestAgent@2 está en desuso. Use la tarea prueba de Visual Studio para ejecutar pruebas unitarias y funcionales.

Sintaxis

# 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.

Entradas

testMachines - Machines
string. Obligatorio.

Esta entrada tiene tres opciones:

Proporciona una lista separada por comas de direcciones IP de máquina o FQDN junto con puertos. El puerto predeterminado se basa en el protocolo seleccionado. Por ejemplo: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986.
Proporciona la variable de salida de otras tareas. Por ejemplo: $(variableName).
Proporciona un nombre de grupo de máquinas. Si usa HTTPS, el nombre o dirección IP de la máquina debe coincidir con el CN en el certificado.

adminUserName - inicio de sesión de administrador
string. Obligatorio.

Especifica el inicio de sesión de administrador para las máquinas de destino.

de contraseña de administrador de adminPassword -
string. Obligatorio.

Especifica la contraseña de administrador de las máquinas de destino. Esta entrada puede aceptar una variable definida en definiciones de compilación o versión como $(passwordVariable). Puede marcar el tipo de variable como secret para protegerlo.

de protocolo winRmProtocol -
string. Obligatorio. Valores permitidos: Http, Https. Valor predeterminado: Http.

Especifica el protocolo que se va a usar para la conexión winRM con las máquinas. El valor predeterminado es HTTPS.

testCertificate - de certificado de prueba
boolean. Opcional. Use cuando winRmProtocol = Https. Valor predeterminado: true.

Proporciona la opción de omitir la validación de autenticidad del certificado de la máquina por una entidad de certificación de confianza. El parámetro es necesario para el protocolo HTTPS de WinRM.

de nombre de usuario de machineUserName -
string. Obligatorio.

Especifica el nombre de usuario con el que debe ejecutarse el agente de prueba.

de contraseña de machinePassword -
string. Obligatorio.

Especifica la contraseña del nombre de usuario especificado anteriormente.

runAsProcess - Ejecutar pruebas de IU
boolean. Valor predeterminado: false.

Indica si el agente de prueba debe ejecutarse como un proceso interactivo. Esta entrada es necesaria para las pruebas automatizadas de IU.

isDataCollectionOnly - Habilitar la recopilación de datos solo
boolean. Valor predeterminado: false.

Opcional. Especifica si el agente de prueba solo se usa para la recopilación de datos y no para ejecutar pruebas. Normalmente, esto se puede encontrar en la aplicación en el grupo de máquinas de prueba (AUT).

de versión del agente de prueba de testPlatform -
string. Valores permitidos: 15.0 (Visual Studio 2017), 14.0 (Visual Studio 2015). Valor predeterminado: 14.0.

Especifica la versión del agente de prueba de Visual Studio. Elige una versión adecuada para que coincida con la versión de VS mediante los archivos binarios de prueba que se compilaron.

agentLocation - ubicación del agente de prueba
string.

Opcional. Proporciona la ruta de acceso a vstf_testagent.exe desde la red o la ubicación local. Si no se proporciona ninguna ruta de acceso, se descargará automáticamente desde el centro de descarga de . Instale el agente de pruebas 2015 Update 3.
instalar el agente de prueba 2017.

updateTestAgent - actualizar del agente de prueba
boolean. Valor predeterminado: false.

Si el Agente de pruebas ya está implementado en una máquina, esta opción comprueba si hay una actualización disponible para esa versión.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Novedades de esta versión de tarea:

Compatibilidad con visual Studio Test Agent 2017: ahora puede implementar y ejecutar pruebas con varias versiones del Agente de pruebas de Visual Studio. Se admiten las versiones 2015 y 2017.
Los grupos de máquinas creados desde el centro de pruebas ya no se admiten. Puede seguir usando una lista de máquinas o grupos de recursos de Azure.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente
demandas	Ninguno
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquiera
variables settable	Cualquiera
Versión del agente	2.0.0 o superior
Categoría de tarea	Prueba

Compartir a través de