Share via


Opciones de la línea de comandos para VSTest.Console.exe

VSTest.Console.exe es el comando de línea de comandos que se utiliza para ejecutar pruebas. Puede especificar varias opciones en cualquier orden en la línea de comandos de VSTest.Console.exe. Estas opciones se muestran en la tabla de opciones generales de la línea de comandos que se incluye más adelante en este tema.

vstest.console.exe interpreta las opciones y valores especificados sin distinguir entre mayúsculas y minúsculas.

En la siguiente tabla se muestran todas las opciones de VSTest.Console.exe junto con una breve descripción. Puede ver un resumen similar escribiendo VSTest.Console /? en una línea de comandos.

Nota

El adaptador de MSTest de Visual Studio 2012 también funciona en modo heredado (lo que equivale a ejecutar pruebas con mstest.exe) por motivos de compatibilidad.Sin embargo, en el modo heredado no podrá aprovechar las nuevas características de TestCaseFilter VS11.El adaptador puede cambiar al modo heredado cuando se especifica el archivo .testsettings, forcelegacymode se establece en true en el archivo .runsettings o se usan atributos como HostType.

Nota

Para ejecutar pruebas automatizadas en un equipo basado en la arquitectura ARM, debe utilizar VSTest.Console.exe.

Opciones generales de la línea de comandos

/Settings:[nombre de archivo]

Ejecuta pruebas con opciones adicionales, como recolectores de datos.

Ejemplo: /Settings:Local.RunSettings

/Tests:[nombre de la prueba]

Ejecuta las pruebas con nombres que coinciden con los

Para proporcionar varios valores, deberá separarlos por comas.

Ejemplo: /Tests:TestMethod1,testMethod2

Nota de precauciónPrecaución
La opción de línea de comandos /Tests no se puede usar con la opción de línea de comandos /TestCaseFilter.

/Enablecodecoverage

Habilita el adaptador de diagnóstico de datos CodeCoverage en la serie de pruebas.

Se usa la configuración predeterminada si no se especifica mediante un archivo de configuración.

/InIsolation

Ejecuta las pruebas en un proceso aislado.

De este modo, es menos probable que el proceso vstest.console.exe se detenga por un error de las pruebas, aunque es posible que las pruebas se ejecuten más despacio.

/UseVsixExtensions

Hace que el proceso vstest.console.exe use u omita las extensiones VSIX instaladas (si procede) en la serie de pruebas.

Ejemplo: /UseVsixExtensions:true

/Platform:[tipo de plataforma]

Arquitectura de la plataforma de destino que se usará para la ejecución de pruebas.

Los valores válidos son x86, x64 y ARM.

/Framework: [versión de Framework]

Versión de .NET Framework de destino que se va a usar en la ejecución de pruebas.

Los valores válidos son Framework35, Framework40 y Framework45.

Ejemplo: /Framework:framework40

/TestCaseFilter:[expresión]

Ejecuta pruebas que coinciden con la expresión dada.

<expresión> tiene el formato <propiedad>=<valor>[|<expresión>].

Ejemplo: /TestCaseFilter:"Priority=1"

Ejemplo: /TestCaseFilter:"TestCategory=Nightly|FullyQualifiedName=Namespace.ClassName.MethodName"

Nota de precauciónPrecaución
La opción de línea de comandos /TestCaseFilter no se puede usar con la opción de línea de comandos /Tests.

/Logger:[uri/nombreDescriptivo]

Especifica un registrador para resultados de pruebas.

Por ejemplo, para registrar resultados en un archivo de resultados de pruebas de Visual Studio (TRX), utilice /Logger:trx.

Por ejemplo, para publicar resultados de pruebas en Team Foundation Server, utilice TfsPublisher:

/logger:TfsPublisher;

Collection=<team project url>;

BuildName=<build name>;

TeamProject=<team project name>;

[;Platform=<Defaults to “Any CPU”>]

[;Flavor=<Defaults to “Debug”>]

[;RunTitle=<title>]

NotaNota
El registrador de TfsPublisher requiere Visual Studio 2012 con [Visual Studio 2012.1] o versiones posteriores.

/ListTests:[nombre de archivo]

Muestra las pruebas detectadas del contenedor de pruebas especificado.

/ListDiscoverers

Muestra los programas de detección de pruebas instalados.

/ListExecutors

Muestra los programas de ejecución de pruebas instalados.

/ListLoggers

Muestra los registradores de pruebas instalados.

/ListSettingsProviders

Muestra los proveedores de configuración de pruebas instalados.

Usar VSTest.Console.exe con archivos de prueba

El uso para vstest.console.exe es:

Vstest.console.exe [TestFileNames] [Options]

A continuación se muestra un ejemplo del uso de VSTest.Console.exe desde la línea de comandos:

Vstest.console.exe myTestProject.dll

A continuación se muestra un ejemplo del uso de VSTest.Console.exe desde la línea de comandos utilizando varios archivos de prueba. Para ello, los nombres de los archivos de prueba deben separarse con espacios:

Vstest.console.exe myTestFile.dll myOtherTestFile.dll

Ejemplo

En el siguiente ejemplo se muestra el uso de algunas de las opciones para ejecutar Vstest.console.exe. En este caso, ejecutará las pruebas en el archivo myTestFile.dll, mientras obtiene los datos especificados en el archivo Local.RunSettings y en un proceso aislado. Además, filtrará los casos de prueba que se van a ejecutar basándose en “Priority 1“ y registrará los resultados en un archivo .trx.

vstest.console.exe  myTestFile.dll /Settings:Local.RunSettings /InIsolation /TestCaseFilter:"Priority=1" /Logger:trx

Vea también

Conceptos

Ejecutar pruebas automatizadas desde la línea de comandos

Usar VSTest.Console desde la línea de comandos