dotnet vstest

This article applies to: ✔️ .NET 6 SDK and later versions

Name

dotnet vstest - Runs tests from the specified assemblies.

Synopsis

dotnet vstest [] [--Blame] [--Collect:]
    [--Diag:] [-e|--Environment:]
    [--Framework:] [--InIsolation] [-lt|--ListTests:]
    [--logger:] [--Parallel]
    [--Platform:] [--ResultsDirectory:]
    [--Settings:] [--TestAdapterPath:]
    [--TestCaseFilter:] [--Tests:] [[--] ...]

dotnet vstest -?|--Help

Description

The dotnet vstest command runs the VSTest.Console command-line application to run automated unit tests. The options in this article are forwarded to vstest.console. For the complete list of command-line options, see vstest.console.exe command line options.

Arguments

• TEST_FILE_NAMES

  Run tests from the specified assemblies. Separate multiple test assembly names with spaces. Wildcards are supported.

Options

• --Blame

  Runs the tests in blame mode. This option is helpful in isolating the problematic tests causing test host to crash. It creates an output file in the current directory as Sequence.xml that captures the order of tests execution before the crash.

• --Collect:

  Enables a data collector for the test run. For example, --Collect:"Code Coverage" collects code coverage with the built-in Visual Studio collector, and --Collect:"XPlat Code Coverage" uses the cross-platform Coverlet collector. For more information, see Monitor and analyze test run.

• --Diag:

  Enables verbose logs for the test platform. Logs are written to the provided file.

• -e|--Environment:

  Sets the value of an environment variable for the test host process. Creates the variable if it doesn't exist, overrides it if it does. Using this option forces the tests to run in an isolated process. Specify the option multiple times to set multiple variables.

• --Framework:

  Target .NET Framework version used for test execution. An example of a valid value is .NETFramework,Version=v7.0. Other supported values are Framework40, Framework45, FrameworkCore10, and FrameworkUap10.

• --InIsolation

  Runs the tests in an isolated process. This makes vstest.console.exe process less likely to be stopped on an error in the tests, but tests may run slower.

• -lt|--ListTests:

  Lists all discovered tests from the given test container.

• --logger:

  Specify a logger for test results.

  • To publish test results to Team Foundation Server, use the TfsPublisher logger provider:

    /logger:TfsPublisher;
        Collection=;
        BuildName=;
        TeamProject=
        [;Platform=]
        [;Flavor=]
        [;RunTitle=