Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
RunVisualStudioTestsusingTestAgent@1 y su tarea complementaria (implementación del agente de prueba de Visual Studio) están en desuso. En su lugar, use la tarea Prueba de Visual Studio. La tarea VSTest puede ejecutar pruebas unitarias y funcionales. Ejecute pruebas en uno o varios agentes mediante la configuración de trabajo multiagente. Use la tarea Plataforma de pruebas de Visual Studio para ejecutar pruebas sin necesidad de Visual Studio en el agente. La tarea VSTest también ofrece nuevas funcionalidades, como volver a ejecutar automáticamente las pruebas con errores.
Sintaxis
# Run functional tests v1
# Deprecated: This task and it’s companion task (Visual Studio Test Agent Deployment) are deprecated. Use the 'Visual Studio Test' task instead. The VSTest task can run unit as well as functional tests. Run tests on one or more agents using the multi-agent job setting. Use the 'Visual Studio Test Platform' task to run tests without needing Visual Studio on the agent. VSTest task also brings new capabilities such as automatically rerunning failed tests.
- task: RunVisualStudioTestsusingTestAgent@1
inputs:
# Setup Options
testMachineGroup: # string. Required. Machines.
dropLocation: # string. Required. Test Drop Location.
# Execution Options
testSelection: 'testAssembly' # 'testAssembly' | 'testPlan'. Required. Test Selection. Default: testAssembly.
#testPlan: # string. Required when testSelection = testPlan. Test Plan.
#testSuite: # string. Required when testSelection = testPlan. Test Suite.
#testConfiguration: # string. Required when testSelection = testPlan. Test Configuration.
sourcefilters: '**\*test*.dll' # string. Required when testSelection = testAssembly. Test Assembly. Default: **\*test*.dll.
#testFilterCriteria: # string. Optional. Use when testSelection = testAssembly. Test Filter criteria.
#runSettingsFile: # string. Run Settings File.
#overrideRunParams: # string. Override Test Run Parameters.
#codeCoverageEnabled: false # boolean. Code Coverage Enabled. Default: false.
#customSlicingEnabled: false # boolean. Distribute tests by number of machines. Default: false.
# Reporting Options
#testRunTitle: # string. Test Run Title.
#platform: # string. Platform.
#configuration: # string. Configuration.
#testConfigurations: # string. Test Configurations.
#autMachineGroup: # string. Application Under Test Machines.
Entradas
testMachineGroup
-
Máquinas
string
. Obligatorio.
Una lista separada por comas de FQDN de máquina o direcciones IP, que puede incluir el número de puerto. El máximo es de 32 máquinas o 32 agentes. Los elementos de lista pueden ser:
- Nombre de un grupo de recursos de Azure .
- Lista delimitada por comas de nombres de máquina. Ejemplo:
dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.34:5986
- Variable de salida de una tarea anterior.
dropLocation
-
ubicación de eliminación de pruebas
string
. Obligatorio.
Especifica la ubicación de las máquinas de prueba en las que se han copiado los archivos binarios de prueba mediante una copia de archivos de máquina Windows o una tarea de copia de archivos de Azure . Las variables de fase del sistema de las máquinas del agente de prueba se pueden usar para especificar la ubicación de colocación. Ejemplos: c:\tests
y %systemdrive%\Tests
.
de selección de pruebas de testSelection
-
string
. Obligatorio. Valores permitidos: testAssembly
(ensamblado de prueba), testPlan
(plan de prueba). Valor predeterminado: testAssembly
.
Especifica cómo se ejecutan las pruebas: mediante ensamblados de prueba o plan de prueba.
del plan de pruebas de testPlan
-
string
. Obligatorio cuando testSelection = testPlan
.
Especifica un plan de prueba que ya está configurado para esta organización.
de testSuite
- Test Suite
string
. Obligatorio cuando testSelection = testPlan
.
Especifica un conjunto de pruebas del plan de pruebas seleccionado.
testConfiguration
-
de configuración de prueba
string
. Obligatorio cuando testSelection = testPlan
.
Especifica una configuración de prueba del plan de prueba seleccionado.
de ensamblado de prueba de sourcefilters
-
string
. Obligatorio cuando testSelection = testAssembly
. Valor predeterminado: **\*test*.dll
.
Especifica los archivos binarios de prueba en los que se van a ejecutar las pruebas. Pueden emplearse comodines. Por ejemplo, **\*test*.dll;
para todos los archivos de .dll
que contienen test
en el nombre de archivo.
testFilterCriteria
-
criterios de filtro de prueba
string
. Opcional. Use cuando testSelection = testAssembly
.
Filtro que especifica las pruebas que se van a ejecutar dentro de los archivos de ensamblado de prueba. Funciona de la misma manera que la opción /TestCaseFilter
en vstest.console.exe
. Ejemplo: Owner=james&Priority=1
.
runSettingsFile
-
archivo de configuración de ejecución
string
.
Especifica la ruta de acceso del archivo al archivo runsettings
o testsettings
que se va a usar con las pruebas.
overrideRunParams
-
invalidar parámetros de ejecución de pruebas
string
.
Especifica los parámetros de invalidación definidos en la sección TestRunParameters
del archivo runsettings
o la sección Properties
del archivo testsettings
. Ejemplo: AppURL=$(DeployURL);Port=8080
.
Nota:
Se puede acceder a las propiedades especificadas en el archivo testsettings
a través de TestContext
mediante test Agent 2017 Update 4 o posterior.
habilitada la cobertura de código de codeCoverageEnabled
-
boolean
. Valor predeterminado: false
.
Especifica si la cobertura de código está habilitada para la tarea.
customSlicingEnabled
-
Distribuir pruebas por número de máquinas
boolean
. Valor predeterminado: false
.
Cuando el valor de este valor booleano se establece en true
, las pruebas se distribuyen en función del número de máquinas proporcionadas en lugar del número de contenedores de prueba.
Nota:
Las pruebas dentro de una .dll
también se pueden distribuir a varias máquinas.
testRunTitle
-
título de ejecución de pruebas
string
.
Especifica un nombre para la ejecución de pruebas.
platform
-
Plataforma
string
.
Especifica la plataforma en la que se deben notificar las pruebas. Si ha definido una variable para platform
en la tarea de compilación, use la variable como valor.
de configuración de configuration
-
string
.
Especifica la configuración con la que se deben notificar las pruebas. Si ha definido una variable para configuration
en la tarea de compilación, use la variable como valor.
configuraciones de prueba de testConfigurations
-
string
.
Opcional. Asocia un filtro de caso de prueba con un identificador de configuración de prueba. Sintaxis: <Filter1>:<Id1>;DefaultTestConfiguration:<Id3>
. Ejemplo: FullyQualifiedName~Chrome:12
.
autMachineGroup
-
aplicación en Máquinas de prueba
string
.
Lista separada por comas de máquinas, variables de salida o nombres de grupo de máquinas en los que se ejecutan los procesos de servidor, como W3WP.exe
, .
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.
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 | 1.104.0 o superior |
Categoría de tarea | Prueba |