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。适配器。.runsettings 文件可以切换到旧模式,当 .testsettings 文件指定时,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|Name=Namespace.ClassName.MethodName"

警告说明警告
/TestCaseFilter 命令行选项不能用于 /Tests 命令行选项。

/Logger:[URI/friendlyname]

为测试结果指定一个记录器。

示例:记录结果到 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 文件中指定的数据,并在独立进程。 此外,它在“优先级别 1 "将筛选测试用例运行基于和记录到 .trx 文件的结果。

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

请参见

概念

从命令行运行自动测试

从命令行使用 VSTest.Console