Freigeben über


Befehlszeilenoptionen für VSTest.Console.exe

 

Veröffentlicht: April 2016

Mit dem Befehl "VSTest.Console.exe" können Sie Tests von einer Befehlszeile aus ausführen. Sie können verschiedene Optionen in beliebiger Reihenfolge in der VSTest.Console.exe-Befehlszeile angeben. Diese Optionen werden weiter unten in diesem Thema in der Tabelle mit den allgemeinen Befehlszeilenoptionen aufgeführt.

"vstest.console.exe" interpretiert diese Optionen und Werte, die Sie unter Beachtung der Groß-/Kleinschreibung angeben.

In der folgenden Tabelle finden Sie eine Übersicht und eine kurze Beschreibung aller Optionen für "VSTest.Console.exe". Eine ähnliche Zusammenfassung wird ausgegeben, wenn Sie VSTest.Console /? in einer Befehlszeile eingeben.

Hinweis

Der MSTest-Adapter in Visual Studio 2012 funktioniert aus Kompatibilitätsgründen auch im Legacymodus (entspricht dem Ausführen von Tests mit "mstest.exe").Im Legacymodus kann er neue VS11-TestCaseFilter-Funktionen nicht nutzen.Der Adapter kann in den Legacymodus wechseln, wenn die TESTSETTINGS-Datei angegeben wird, "forcelegacymode" in der RUNSETTINGS-Datei auf "true" festgelegt ist oder Attribute wie HostType verwendet werden.

Hinweis

Um automatisierte Tests auf einem auf der ARM-Architektur basierten Computer auszuführen, müssen Sie "VSTest.Console.exe" verwenden.

Allgemeine Befehlszeilenoptionen

/Settings:[ Dateiname ]

Führen Sie Tests mit zusätzlichen Einstellungen wie Datensammlern aus.

Ein Beispiel: /Settings:Local.RunSettings

/Tests:[ Testname ]

Führt Tests aus, die mit den eingegebenen Werten übereinstimmen.

Um mehrere Werte bereitzustellen, trennen Sie diese durch Kommas.

Ein Beispiel: /Tests:TestMethod1,testMethod2

Warnung

Die Befehlszeilenoption /Tests kann nicht mit der Befehlszeilenoption /TestCaseFilter verwendet werden.

/Enablecodecoverage

Aktiviert den CodeCoverage-Datendiagnoseadapter im Testlauf.

Die Standardeinstellungen werden verwendet, wenn keine Einstellungsdatei angegeben wurde.

/InIsolation

Führt die Tests in einem isolierten Prozess aus.

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.

/UseVsixExtensions

Hierdurch verwendet der vstest.console.exe-Prozess die VSIX-Erweiterungen, die im Testlauf (ggf.) installiert wurden, oder überspringt sie.

Ein Beispiel: /UseVsixExtensions:true

/Platform:[ Plattformtyp ]

Zielplattformarchitektur für die Testausführung.

Gültige Werte sind x86, x64 und ARM.

/Framework: [ Frameworkversion ]

.NET Framework-Zielversion, in der der Test ausgeführt wird.

Gültige Werte sind Framework35, Framework40 und Framework45.

Ein Beispiel: /Framework:framework40

/TestCaseFilter:[ Ausdruck ]

Führt Tests aus, die mit dem angegebenen Ausdruck übereinstimmen.

<Expression> ist vom Format <property>=<value>[|<Expression>].

Ein Beispiel: /TestCaseFilter:"Priority=1"

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

Warnung

Die Befehlszeilenoption /TestCaseFilter kann nicht mit der Befehlszeilenoption /Tests verwendet werden.

/Logger:[ uri/friendlyname ]

Geben Sie eine Protokollierung für die Testergebnisse an.

Beispiel: Verwenden Sie zum Protokollieren von Ergebnissen in einer Visual Studio-Testergebnisdatei (TRX) /Logger:trx.

Beispiel: Verwenden Sie TfsPublisher zum Veröffentlichen von Testergebnissen in Team Foundation Server:

/logger:TfsPublisher;

Collection=<team project url>;

BuildName=<build name>;

TeamProject=<team project name>;

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

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

[;RunTitle=<title>]

Hinweis

Für die TfsPublisher-Protokollierung ist Visual Studio 2012 mit [Visual Studio 2012.1] oder höher erforderlich.

/ListTests:[ Dateiname ]

Listet gefundene Tests aus dem angegebenen Testcontainer auf.

/ListDiscoverers

Listet alle installierten Test-Discoverer auf.

/ListExecutors

Listet alle installierten Test-Executors auf.

/ListLoggers

Listet alle installierten Testprotokollierungen auf.

/ListSettingsProviders

Listet alle installierten Testeinstellungsanbieter auf.

Verwenden von "VSTest.Console.exe" mit Testdateien

"vstest.console.exe" wird folgendermaßen verwendet:

Vstest.console.exe [TestFileNames] [Options]

Im Folgenden finden Sie ein Beispiel für die Verwendung von "VSTest.Console.exe" von der Befehlszeile aus:

Vstest.console.exe myTestProject.dll

Im Folgenden finden Sie ein Beispiel für die Verwendung von "VSTest.Console.exe" von der Befehlszeile aus mithilfe mehrerer Testdateien. Hierzu werden die Testdateinamen mit Leerzeichen getrennt:

Vstest.console.exe myTestFile.dll myOtherTestFile.dll

Beispiel

Das folgende Beispiel zeigt die Verwendung einiger Optionen für die Ausführung von "Vstest.console.exe". In diesem Fall werden die Tests in der Datei "myTestFile.dll" ausgeführt, während die Daten, die in der Local.RunSettings-Datei und in einem isolierten Prozess angegeben werden, gesammelt werden. Außerdem werden die Testfälle gefiltert, um basiert auf "Priorität 1" ausgeführt zu werden, und die Ergebnisse werden in einer TRX-Datei protokolliert.

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

Siehe auch

Ausführen von automatisierten Tests über die Befehlszeile
Verwenden von VSTest.console über die Befehlszeile