dotnet vstestdotnet vstest

Este tema se aplica a: ✓ SDK de .NET Core 1.x SDK de .NET Core 2.xThis topic applies to: ✓ .NET Core 1.x SDK .NET Core 2.x SDK

nombreName

dotnet-vstest: ejecuta pruebas desde los archivos especificados.dotnet-vstest - Runs tests from the specified files.

SinopsisSynopsis

dotnet vstest [<TEST_FILE_NAMES>] [--Settings|/Settings] [--Tests|/Tests] [--TestAdapterPath|/TestAdapterPath]
    [--Platform|/Platform] [--Framework|/Framework] [--Parallel|/Parallel] [--TestCaseFilter|/TestCaseFilter] [--logger|/logger]
    [-lt|--ListTests|/lt|/ListTests] [--ParentProcessId|/ParentProcessId] [--Port|/Port] [--Diag|/Diag] [--Blame|/Blame] [--InIsolation|/InIsolation]
    [[--] <args>...]] [-?|--Help|/?|/Help]

DescripciónDescription

El comando dotnet-vstest ejecuta la aplicación de línea de comandos VSTest.Console para ejecutar pruebas unitarias automatizadas.The dotnet-vstest command runs the VSTest.Console command-line application to run automated unit tests.

ArgumentosArguments

TEST_FILE_NAMES

Ejecutar pruebas desde los ensamblados especificados.Run tests from the specified assemblies. Separar varios nombres de ensamblado de prueba con espacios.Separate multiple test assembly names with spaces.

OpcionesOptions

--Settings|/Settings:<Settings File>

Configuración que se usará al ejecutar las pruebas.Settings to use when running tests.

--Tests|/Tests:<Test Names>

Ejecuta las pruebas con nombres que coinciden con losRun tests with names that match the provided values. Separar varios valores con comas.Separate multiple values with commas.

--TestAdapterPath|/TestAdapterPath

Usar adaptadores de prueba personalizados desde una ruta de acceso especificada (si existe) en la serie de pruebas.Use custom test adapters from a given path (if any) in the test run.

--Platform|/Platform:<Platform type>

Identificar la arquitectura de la plataforma usada en la ejecución de pruebas.Target platform architecture used for test execution. Valores válidos son x86, x64 y ARM.Valid values are x86, x64, and ARM.

--Framework|/Framework:<Framework Version>

Identificar la versión de .NET Framework usada en la ejecución de pruebas.Target .NET Framework version used for test execution. Ejemplos de valores válidos son .NETFramework,Version=v4.6 o .NETCoreApp,Version=v1.0.Examples of valid values are .NETFramework,Version=v4.6 or .NETCoreApp,Version=v1.0. Otros valores admitidos son Framework40, Framework45, FrameworkCore10 y FrameworkUap10.Other supported values are Framework40, Framework45, FrameworkCore10, and FrameworkUap10.

--Parallel|/Parallel

Ejecutar pruebas en paralelo.Execute tests in parallel. De forma predeterminada, todos los núcleos disponibles en el equipo están disponibles para su uso.By default, all available cores on the machine are available for use. Especifique un número explícito de núcleos mediante la configuración de la propiedad MaxCpuCount en el nodo RunConfiguration del archivo runsettings.Specify an explicit number of cores by setting the MaxCpuCount property under the RunConfiguration node in the runsettings file.

--TestCaseFilter|/TestCaseFilter:<Expression>

Ejecuta pruebas que coinciden con la expresión dada.Run tests that match the given expression. <Expression> tiene el formato <property>Operator<value>[|&<Expression>], donde Operator es =, != o ~.<Expression> is of the format <property>Operator<value>[|&<Expression>], where Operator is one of =, !=, or ~. El operador ~ tiene semántica "contains" y se aplica a las propiedades de cadena como DisplayName.Operator ~ has 'contains' semantics and is applicable for string properties like DisplayName. Los paréntesis () se usan para agrupar expresiones secundarias.Parenthesis () are used to group sub-expressions.

-?|--Help|/?|/Help

Imprime una corta ayuda para el comando.Prints out a short help for the command.

--logger|/logger:<Logger Uri/FriendlyName>

Especifica un registrador para resultados de pruebas.Specify a logger for test results.

  • Para publicar resultados de pruebas en Team Foundation Server, use el proveedor de registrador TfsPublisher:To publish test results to Team Foundation Server, use the TfsPublisher logger provider:

    /logger:TfsPublisher;
        Collection=<team project collection url>;
        BuildName=<build name>;
        TeamProject=<team project name>
        [;Platform=<Defaults to "Any CPU">]
        [;Flavor=<Defaults to "Debug">]
        [;RunTitle=<title>]
    
  • Para registrar los resultados en un archivo de resultados de pruebas (TRX) de Visual Studio, use el proveedor de registrador trx.To log results to a Visual Studio Test Results File (TRX), use the trx logger provider. Este modificador, crea un archivo en el directorio de resultados de pruebas con un nombre de archivo de registro dado.This switch creates a file in the test results directory with given log file name. Si no se proporciona LogFileName, se crea un nombre de archivo único para contener los resultados de las pruebas.If LogFileName isn't provided, a unique file name is created to hold the test results.

    /logger:trx [;LogFileName=<Defaults to unique file name>]
    

-lt|--ListTests|/lt|/ListTests:<File Name>

Muestra todas las pruebas detectadas del contenedor de pruebas especificado.Lists all discovered tests from the given test container.

--ParentProcessId|/ParentProcessId:<ParentProcessId>

Id. de proceso del proceso principal responsable de iniciar el proceso actual.Process ID of the parent process responsible for launching the current process.

--Port|/Port:<Port>

Especifica el puerto para la conexión de socket y la recepción de mensajes de eventos.Specifies the port for the socket connection and receiving the event messages.

--Diag|/Diag:<Path to log file>

Permite registros detallados para la plataforma de prueba.Enables verbose logs for the test platform. Los registros se escriben en el archivo proporcionado.Logs are written to the provided file.

--Blame|/Blame

Ejecuta las pruebas en el modo de culpabilidad.Runs the tests in blame mode. Esta opción es útil para aislar las pruebas problemáticas que hacen que el host de prueba se bloquee.This option is helpful in isolating the problematic tests causing test host to crash. Crea un archivo de salida en el directorio actual como Sequence.xml que captura el orden de ejecución de pruebas antes del bloqueo.It creates an output file in the current directory as Sequence.xml that captures the order of tests execution before the crash.

--InIsolation|/InIsolation

Ejecuta las pruebas en un proceso aislado.Runs the tests in an isolated process. De este modo, es menos probable que el proceso vstest.console.exe se detenga por un error de las pruebas, pero es posible que las pruebas se ejecuten más despacio.This makes vstest.console.exe process less likely to be stopped on an error in the tests, but tests may run slower.

@<file>

Lee el archivo de respuesta para ver más opciones.Reads response file for more options.

args

Especifica argumentos adicionales para pasar al adaptador.Specifies extra arguments to pass to the adapter. Los argumentos se especifican como pares de nombre-valor en el formato <n>=<v>, donde <n> es el nombre del argumento y <v> es el valor del argumento.Arguments are specified as name-value pairs of the form <n>=<v>, where <n> is the argument name and <v> is the argument value. Use un espacio para separar varios argumentos.Use a space to separate multiple arguments.

EjemplosExamples

Ejecutar pruebas en mytestproject.dll:Run tests in mytestproject.dll:

dotnet vstest mytestproject.dll

Ejecutar pruebas en mytestproject.dll, exportando a carpeta personalizada con nombre personalizado:Run tests in mytestproject.dll, exporting to custom folder with custom name:

dotnet vstest mytestproject.dll --logger:"trx;LogFileName=custom_file_name.trx" --ResultsDirectory:custom/file/path

Ejecutar pruebas en mytestproject.dll y myothertestproject.exe:Run tests in mytestproject.dll and myothertestproject.exe:

dotnet vstest mytestproject.dll myothertestproject.exe

Ejecutar pruebas TestMethod1:Run TestMethod1 tests:

dotnet vstest /Tests:TestMethod1

Ejecutar pruebas TestMethod1 y TestMethod2:Run TestMethod1 and TestMethod2 tests:

dotnet vstest /Tests:TestMethod1,TestMethod2