共用方式為


VSTest.Console.exe 命令列選項

VSTest.Console.exe 是用於執行測試的命令列命令。 您可以依照任何順序在 VSTest.Console.exe 命令列中指定數個選項。 本主題後面的一般命令列選項表中列出這些選項。

vstest.console.exe 以不區分大小寫方式解譯這些選項和您指定的值。

下表列出了 VSTest.Console.exe 的所有選項,以及選項的簡短描述。 在命令列輸入 VSTest.Console /? 也能看到類似的摘要。

注意事項注意事項

基於相容性,Visual Studio 2012 的 MSTest 配接器也可以在舊版模式下運作 (相當於使用 mstest.exe 執行測試)。在舊版模式下,不會使用新 VS11 的 TestCaseFilter 功能。已指定 .testsettings 檔案、.runsettings 檔案中 forcelegacymode 設為 true 或使用屬性 (如 HostType) 時,配接器會切換到舊版模式。

注意事項注意事項

若要在 ARM 架構電腦上執行自動化測試,您必須使用 VSTest.Console.exe。

一般命令列選項

/Settings:[檔案名稱]

使用像資料收集器之類的其他設定執行測試。

範例:/Settings:Local.RunSettings

/Tests:[測試名稱]

執行測試,其名稱符合所提供的值。

若要提供多個值,請使用逗號來區隔。

範例:/Tests:TestMethod1,testMethod2

注意事項警告
/Tests 命令列選項不能與 /TestCaseFilter 命令列選項同時使用。

/Enablecodecoverage

在測試回合中啟用資料診斷配接器 CodeCoverage。

如果沒有使用設定檔來指定,則使用預設設定。

/InIsolation

在獨立的處理序中執行測試。

這樣會降低 vstest.console.exe 處理序在測試中錯誤處停止的可能性,但是測試的速度可能會比較慢。

/UseVsixExtensions

這可讓 vstest.console.exe 處理序使用或略過測試回合中已安裝的 VSIX 擴充功能 (如果有的話)。

範例:/UseVsixExtensions:true

/Platform:[平台類型]

要用於測試執行的目標平台架構。

有效值為 x86、x64 和 ARM。

/Framework: [Framework 版本]

要用於測試執行的目標 .NET Framework 版本。

有效值為 Framework35、Framework40 和 Framework45。

範例:/Framework:framework40

/TestCaseFilter:[運算式]

執行符合指定之運算式的測試。

<Expression> 的格式為 <property>=<value>[|<Expression>]。

範例:/TestCaseFilter:"Priority=1"

範例:/TestCaseFilter:"TestCategory=Nightly|FullyQualifiedName=Namespace.ClassName.MethodName"

注意事項警告
/TestCaseFilter 命令列選項不能與 /Tests 命令列選項同時使用。

/Logger:[URI/易記名稱]

指定測試結果的記錄器。

範例:若要將結果記錄到 Visual Studio 測試結果檔案 (TRX),請使用 /Logger:trx

範例:若要將測試結果發行到 Team Foundation Server,請使用 TfsPublisher:

/logger:TfsPublisher;

Collection=<team project url>;

BuildName=<build name>;

TeamProject=<team project name>;

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

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

[;RunTitle=<title>]

注意事項注意事項
TfsPublisher 記錄器需要 Visual Studio 2012 與 [Visual Studio 2012.1] (含) 以後版本。

/ListTests:[檔案名稱]

列出從指定之測試容器探索到的測試。

/ListDiscoverers

列出已安裝的測試探索程式。

/ListExecutors

列出已安裝的測試執行程式。

/ListLoggers

列出已安裝的測試記錄器。

/ListSettingsProviders

列出已安裝的測試設定提供者。

VSTest.Console.exe 和測試檔案一起使用

vstest.console.exe 用法如下:

Vstest.console.exe [TestFileNames] [Options]

下列範例示範如何從命令列使用 VSTest.Console.exe:

Vstest.console.exe myTestProject.dll

下列範例示範如何從命令列使用 VSTest.Console.exe 與多個測試檔案。 這個做法中以空格分隔測試檔案名稱:

Vstest.console.exe myTestFile.dll myOtherTestFile.dll

範例

下列範例示範如何使用一些選項來執行 Vstest.console.exe。 在這個案例中,將會執行 myTestFile.dll 檔案中的測試,並且收集 Local.RunSettings 裡和隔離處理序內指定的資料。 此外,它會根據 "Priority 1" 篩選要執行的測試案例,並將結果記錄到 .trx 檔案。

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

請參閱

概念

從命令列執行自動化的測試

從命令列使用 VSTest.console