Befehlszeilenoptionen für VSTest.Console.exe
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:[file name] |
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 .gif "Warnhinweis") Vorsicht
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" Vorsicht
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>] .gif "Hinweis") Hinweis
Die TfsPublisher-Protokollierung erfordert Visual Studio 2012 mit [Visual Studio 2012.1] oder höher.
|
/ListTests:[file name] |
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