dotnet vstestdotnet vstest

Dieser Artikel gilt für: ✔️ .NET Core 2.1 SDK und neuere VersionenThis article applies to: ✔️ .NET Core 2.1 SDK and later versions

Wichtig

Der Befehl dotnet vstest wird von dotnet test abgelöst, der nun zum Ausführen von Assemblys verwendet werden kann.The dotnet vstest command is superseded by dotnet test, which can now be used to run assemblies. Weitere Informationen finden Sie unter dotnet test.See dotnet test.

nameName

dotnet-vstest: Führt Tests auf Grundlage der angegebenen Assemblys aus.dotnet-vstest - Runs tests from the specified assemblies.

ÜbersichtSynopsis

dotnet vstest [<TEST_FILE_NAMES>] [--Blame] [--Diag <PATH_TO_LOG_FILE>]
    [--Framework <FRAMEWORK>] [--InIsolation] [-lt|--ListTests <FILE_NAME>]
    [--logger <LOGGER_URI/FRIENDLY_NAME>] [--Parallel]
    [--ParentProcessId <PROCESS_ID>] [--Platform] <PLATFORM_TYPE>
    [--Port <PORT>] [--ResultsDirectory<PATH>] [--Settings <SETTINGS_FILE>]
    [--TestAdapterPath <PATH>] [--TestCaseFilter <EXPRESSION>]
    [--Tests <TEST_NAMES>] [[--] <args>...]]

dotnet vstest -?|--Help

BeschreibungDescription

Der dotnet-vstest-Befehl führt die VSTest.Console-Befehlszeilenanwendung aus, um automatisierte Komponententests auszuführen.The dotnet-vstest command runs the VSTest.Console command-line application to run automated unit tests.

ArgumenteArguments

  • TEST_FILE_NAMES

    Führt Tests auf Grundlage der angegebenen Assemblys aus.Run tests from the specified assemblies. Trennt mehrere Test-Assemblynamen durch Leerzeichen.Separate multiple test assembly names with spaces. Platzhalter werden unterstützt.Wildcards are supported.

OptionenOptions

  • --Blame

    Führt die Tests im blame-Modus aus.Runs the tests in blame mode. Diese Option hilft beim Isolieren der fehlerhaften Tests, die den Absturz des Testhosts verursachen.This option is helpful in isolating the problematic tests causing test host to crash. In dem aktuellen Verzeichnis wird eine Ausgabedatei als Sequence.xml erstellt, die die Reihenfolge der ausgeführten Tests vor dem Absturz erfasst.It creates an output file in the current directory as Sequence.xml that captures the order of tests execution before the crash.

  • --Diag <PATH_TO_LOG_FILE>

    Aktiviert die ausführlichen Protokolle für die Testplattform.Enables verbose logs for the test platform. Protokolle werden in die angegebene Datei geschrieben.Logs are written to the provided file.

  • --Framework <FRAMEWORK>

    .NET Framework-Zielversion, in der der Test ausgeführt wird.Target .NET Framework version used for test execution. .NETFramework,Version=v4.6 und .NETCoreApp,Version=v1.0 sind Beispiele für gültige Werte.Examples of valid values are .NETFramework,Version=v4.6 or .NETCoreApp,Version=v1.0. Andere unterstützte Werte sind Framework40, Framework45, FrameworkCore10 und FrameworkUap10.Other supported values are Framework40, Framework45, FrameworkCore10, and FrameworkUap10.

  • --InIsolation

    Führt die Tests in einem isolierten Prozess aus.Runs the tests in an isolated process. Dadurch ist die Wahrscheinlichkeit, dass der vstest.console.exe-Prozess bei Testfehlern beendet wird, weniger hoch, die Tests werden jedoch möglicherweise langsamer ausgeführt.This makes vstest.console.exe process less likely to be stopped on an error in the tests, but tests may run slower.

  • -lt|--ListTests <FILE_NAME>

    Listet alle gefundenen Tests aus dem angegebenen Testcontainer auf.Lists all discovered tests from the given test container.

  • --logger <LOGGER_URI/FRIENDLY_NAME>

    Geben Sie eine Protokollierung für die Testergebnisse an.Specify a logger for test results.

    • Verwenden Sie den TfsPublisher-Protokollierungsanbieter zum Veröffentlichen von Testergebnissen in Team Foundation Server: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>]
      
    • Verwenden Sie zum Protokollieren von Ergebnissen in einer Visual Studio-Testergebnisdatei (TRX) den trx-Protokollierungsanbieter.To log results to a Visual Studio Test Results File (TRX), use the trx logger provider. Dieser Schalter erstellt eine Datei im Verzeichnis mit den Testergebnissen mit dem angegebenen Protokolldateinamen.This switch creates a file in the test results directory with given log file name. Wenn LogFileName nicht angegeben wird, wird ein eindeutiger Dateiname erstellt, um die Testergebnisse aufzunehmen.If LogFileName isn't provided, a unique file name is created to hold the test results.

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

    Mit dieser Option können Sie Tests parallel ausführen.Run tests in parallel. Standardmäßig stehen alle verfügbaren Kerne auf dem Computer zur Nutzung zur Verfügung.By default, all available cores on the machine are available for use. Geben Sie eine explizite Anzahl von Kernen an, indem Sie die MaxCpuCount-Eigenschaft unter dem RunConfiguration-Knoten in der Datei runsettings festlegen.Specify an explicit number of cores by setting the MaxCpuCount property under the RunConfiguration node in the runsettings file.

  • --ParentProcessId <PROCESS_ID>

    Prozess-ID des übergeordneten Prozesses, der für den Start des aktuellen Prozesses verantwortlich ist.Process ID of the parent process responsible for launching the current process.

  • --Platform <PLATFORM_TYPE>

    Verwendete Zielplattformarchitektur für die Testausführung.Target platform architecture used for test execution. Gültige Werte sind x86, x64 und ARM.Valid values are x86, x64, and ARM.

  • --Port <PORT>

    Gibt den Port für die Socketverbindung an und empfängt die Ereignismeldungen.Specifies the port for the socket connection and receiving the event messages.

  • --ResultsDirectory:<PATH>

    Das Verzeichnis mit den Testergebnissen wird am angegebenen Pfad erstellt, falls es noch nicht vorhanden ist.Test results directory will be created in specified path if not exists.

  • --Settings <SETTINGS_FILE>

    Einstellungen, die beim Ausführen von Tests verwendet werden.Settings to use when running tests.

  • --TestAdapterPath <PATH>

    Verwendet benutzerdefinierte Testadapter aus einem angegebenen Pfad (falls vorhanden) im Testlauf.Use custom test adapters from a given path (if any) in the test run.

  • --TestCaseFilter <EXPRESSION>

    Führt Tests aus, die mit dem angegebenen Ausdruck übereinstimmen.Run tests that match the given expression. <EXPRESSION> hat das Format <property>Operator<value>[|&<EXPRESSION>], wobei der Operator =, !=, oder ~ ist.<EXPRESSION> is of the format <property>Operator<value>[|&<EXPRESSION>], where Operator is one of =, !=, or ~. Operator ~ verfügt über „contains“-Semantik und gilt für Zeichenfolgeneigenschaften wie DisplayName.Operator ~ has 'contains' semantics and is applicable for string properties like DisplayName. Klammern () werden zum Gruppieren untergeordneter Ausdrücke verwendet.Parentheses () are used to group subexpressions. Weitere Informationen finden Sie unter TestCase-Filter.For more information, see TestCase filter.

  • --Tests <TEST_NAMES>

    Führt Tests aus, die mit den eingegebenen Werten übereinstimmen.Run tests with names that match the provided values. Trennt mehrere Werte per Komma voneinander ab.Separate multiple values with commas.

  • -?|--Help

    Druckt eine kurze Hilfe für den Befehl.Prints out a short help for the command.

  • @<file>

    Liest eine Antwortdatei für mehrere Optionen.Reads response file for more options.

  • args

    Gibt zusätzliche Argumente an, die an den Adapter übergeben werden sollen.Specifies extra arguments to pass to the adapter. Argumente werden als Name-Wert-Paare des Formulars <n>=<v> angegeben, wobei <n> der Argumentname und <v> der Argumentwert ist.Arguments are specified as name-value pairs of the form <n>=<v>, where <n> is the argument name and <v> is the argument value. Trennt mehrere Argumente durch Leerzeichen.Use a space to separate multiple arguments.

BeispieleExamples

Mit dem folgenden Befehl werden Tests in mytestproject.dll ausgeführt:Run tests in mytestproject.dll:

dotnet vstest mytestproject.dll

Mit dem folgenden Befehl werden Tests in mytestproject.dll ausgeführt und in einen benutzerdefinierten Ordner mit benutzerdefiniertem Namen exportiert: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

Mit dem folgenden Befehl werden Tests in mytestproject.dll und myothertestproject.exe ausgeführt:Run tests in mytestproject.dll and myothertestproject.exe:

dotnet vstest mytestproject.dll myothertestproject.exe

Führt TestMethod1-Tests aus:Run TestMethod1 tests:

dotnet vstest /Tests:TestMethod1

Führt TestMethod1- und TestMethod2-Tests aus:Run TestMethod1 and TestMethod2 tests:

dotnet vstest /Tests:TestMethod1,TestMethod2

Siehe auchSee also