dotnet vstestdotnet vstest

Dieses Thema gilt für: ✓ .NET Core SDK 1.x .NET Core SDK 2.xThis topic applies to: ✓ .NET Core SDK 1.x .NET Core SDK 2.x

nameName

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

ÜbersichtSynopsis

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]

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.

OptionenOptions

--Settings|/Settings:<Settings File>

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

--Tests|/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.

--TestAdapterPath|/TestAdapterPath

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.

--Platform|/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.

--Framework|/Framework:<Framework Version>

.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.

--Parallel|/Parallel

Führt Tests parallel aus.Execute 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 Knoten „RunConfiguration“ in der Datei „runsettings“ festlegen.Specify an explicit number of cores by setting the MaxCpuCount property under the RunConfiguration node in the runsettings file.

--TestCaseFilter|/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 verwendet, um untergeordnete Ausdrücke zu gruppieren.Parenthesis () are used to group sub-expressions.

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

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

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

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>]
    

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

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

--ParentProcessId|/ParentProcessId:<ParentProcessId>

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.

--Port|/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.

--Diag|/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.

--Blame|/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.

--InIsolation|/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.

@<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

Führt Tests in mytestproject.dll aus:Run tests in mytestproject.dll:

dotnet vstest mytestproject.dll

Führen Sie Tests in mytestproject.dll aus, und exportieren Sie sie in den benutzerdefinierten Ordner mit benutzerdefiniertem Namen: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

Führt Tests in mytestproject.dll und myothertestproject.exe aus: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