Verwenden von VSTest.console über die Befehlszeile
Veröffentlicht: Juli 2016
Führen Sie mit "VSTest.Console.exe" entweder Einheiten- oder codierte UI-Tests über die Befehlszeile aus. Diese Datei ist im Hinblick auf die Leistung optimiert und wird anstelle von "MSTest.exe" in Visual Studio 2012 oder höher verwendet.
Geben Sie mehrere Optionen in beliebiger Reihenfolge in der Befehlszeile von "VSTest.Console.exe" an. Diese Optionen sind in der folgenden Tabelle für allgemeine 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. "VSTest.Console.exe" befindet sich hier: C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\TestWindow.
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
Compatibility of Test Settings with Visual Studio 2010
Upgrading Tests from Earlier Versions of Visual Studio