使用 tcm 从命令行运行自动测试

可以从命令行使用 tcm.exe 运行具有关联的自动化的测试用例,而不使用 Microsoft 测试管理器提供的用户界面。 这使你可以从批处理文件自动启动运行。 例如,你可以决定安排该批处理文件在每次完成生成时运行。

若要运行这些自动测试用例以便将测试结果作为测试计划的一部分,你必须使用实验室环境。 从命令行启动运行时,请使用 tcm.exe。 必须指定包含运行测试所需角色集的测试设置,以及包含此角色集的环境。 有关测试设置和环境的更多信息,请参见设置测试计算机以运行测试或收集数据

备注

如果要运行的自动测试将与桌面交互,必须将代理设置为作为进程而非服务运行。有关详细信息,请参阅如何:设置测试代理以运行与桌面交互的测试

可以使用查询来指定测试用例和配置对(称为“测试点”),也可以指定要从测试计划运行的测试套件和配置。 你必须知道测试计划、测试套件和配置的 ID。 如果需要,可以使用 tcm.exe 列出这些信息。

使用以下过程可收集从命令行运行自动测试所必需的信息,然后运行测试:

  • 列出团队项目中的所有配置

  • 列出团队项目中的所有测试计划

  • 列出团队项目的所有测试环境

  • 列出测试计划中的所有测试套件

  • 使用测试点查询创建测试运行

  • 为测试套件和特定配置创建测试运行

  • 查看和更新测试结果

常用过程参数

参数

描述

/collection:CollectionURL

指定团队项目集合的 URI。 URI 的格式如下:http://ServerName:Port/VirtualDirectoryName/CollectionName

如果未使用虚拟目录,则 URI 将为以下格式:

http://ServerName:Port/CollectionName

如果你不知道正确的路径,请联系你的 Team Foundation 系统管理员。

/teamproject:TeamProjectName

要使用的团队项目。 必须在 /collection 参数指定的项目集合中定义此团队项目。

/login:用户名、密码

可选。 指定登录到 Team Foundation Server 的应用层服务器并有权运行该命令的用户的名称和密码。

如果你的 Windows 凭据没有适当权限、你使用的是基本身份验证或者你未连接到域,你将使用此选项。

要登录到 Visual Studio Online,你还需使用下列 /allowalternatecredentials

/allowalternatecredentials

连接到 Visual Studio Online 时,不仅需要指定 /login 参数,还必须指定此标志。 (仅当使用 Visual Studio 2013 Update 4 或更高版本时,此标志才可用。)

/build

可选。 指定将与测试运行关联的生成号。 如果未指定 /buildDir 选项,则将使用此生成的放置位置来选取测试二进制文件。

/buildDefinition

生成所属的生成定义的名称。

/flavor

要使用的生成风格(如果生成有多种生成风格)。

/platform

要使用的生成平台(如果生成有多个生成平台)。

/?help

在“命令提示符”窗口中显示有关命令的帮助。

过程

列出团队项目中的所有配置

列出团队项目中的所有配置

  1. 打开一个 Visual Studio 命令提示符。

    为此,请选择**“开始”,指向“所有程序”,指向“Microsoft Visual Studio 2012”,指向“Visual Studio 工具”,然后选择“开发人员命令提示”**。

    命令提示打开文件夹:<驱动器>:\Program Files\Microsoft Visual Studio 11.0\VC

  2. 若要列出团队项目中的所有配置,请在命令提示符下键入以下内容:

    tcm configs /list /collection:<CollectionURL> /teamproject:<Team Project name>

    你将看到类似如下的结果:

    Id Name

    ---------------- ------------------

    1 Vista and IE 7

    25 Vista and IE 8

    备注

    还可以使用下面的命令列出团队项目的计划:Tcm plans /list /collection:<CollectionURL> /teamproject:<Team Project name>

列出团队项目中的所有测试计划

列出团队项目中的所有测试计划

  1. 打开一个 Visual Studio 命令提示符。

    为此,请选择**“开始”,指向“所有程序”,指向“Microsoft Visual Studio 2012”,指向“Visual Studio 工具”,然后选择“开发人员命令提示”**。

    命令提示打开文件夹:<驱动器>:\Program Files\Microsoft Visual Studio 11.0\VC

  2. 若要列出团队项目中的所有计划,请在命令提示符下键入以下内容:

    tcm plans /list /collection:<CollectionURL> /teamproject:<Team Project name>

    你将看到类似如下的结果:

    Id Name

    ---------------- ------------------

    1 Beta 1 Test Plan

    22 RTM Test Plan

  3. (可选)若要查找测试计划中的所有测试套件,请在命令提示符下键入以下内容:

    tcm suites /list /planid:<your plan id> /collection:<CollectionURL> /teamproject:<Team Project name>

    你将看到类似如下的结果:

    Id Name

    ---------------- ------------------

    1 Priority 1 Test Suite

    15 Shopping Cart Test Suite

列出团队项目的所有测试环境

列出团队项目的所有测试环境

  1. 打开一个 Visual Studio 命令提示符。

    为此,请选择**“开始”,指向“所有程序”,指向“Microsoft Visual Studio 2012”,指向“Visual Studio 工具”,然后选择“开发人员命令提示”**。

    命令提示打开文件夹:<驱动器>:\Program Files\Microsoft Visual Studio 11.0\VC

  2. 若要列出团队项目中的所有计划,请在命令提示符下键入以下内容:

    tcm testenvironments /list /collection:<CollectionURL> /teamproject:<Team Project name>

    你将看到类似如下的结果:

    Name Description

    ---------------- ------------------

    Staging Environment Use to test staging environment

    Testing Environment for Customer ABC

列出测试计划中的所有测试套件

列出测试计划中的所有测试套件

  1. 打开一个 Visual Studio 命令提示符。

    为此,请选择**“开始”,指向“所有程序”,指向“Microsoft Visual Studio 2012”,指向“Visual Studio 工具”,然后选择“开发人员命令提示”**。

    命令提示打开文件夹:<驱动器>:\Program Files\Microsoft Visual Studio 11.0\VC

  2. 若要查找测试计划中的所有测试套件,请在命令提示符下键入以下内容:

    tcm suites /list /planid:<your plan id> /collection:<CollectionURL> /teamproject:<Team Project name>

    你将看到类似如下的结果:

    Id Name

    ---------------- ------------------

    1 Priority 1 Test Suite

    15 Shopping Cart Test Suite

使用测试点查询创建测试运行

使用测试点查询创建测试运行

  1. 打开一个 Visual Studio 命令提示符。

    为此,请选择**“开始”,指向“所有程序”,指向“Microsoft Visual Studio 2012”,指向“Visual Studio 工具”,然后选择“开发人员命令提示”**。

    命令提示打开文件夹:<驱动器>:\Program Files\Microsoft Visual Studio 11.0\VC

  2. 若要创建对特定测试配置使用测试点查询的测试运行,请使用下表中的信息。

    Id

    Planid

    1

    Configid

    13

    在命令提示符处键入以下内容:

    tcm run /create /title:"Nightly Run" /planid:1 /querytext:"SELECT * FROM TestPoint WHERE ConfigurationId=13" /settingsname:"<Name of your automated test settings>" /testenvironment:"<Name of a matching environment>" /collection:<CollectionURL> /teamproject:<Team Project name>

    你将看到类似如下的结果:

    Run created with ID: <xxx>.

    备注

    必须使用 tcm.exe 为自动测试运行提供测试设置和与测试设置中的角色集匹配的环境。有关测试设置和环境的更多信息,请参见设置测试计算机以运行测试或收集数据。若要创建测试设置,请参见使用 Microsoft 测试管理器为自动系统测试创建测试设置

  3. 若要查看测试运行的进度,请按照查看和更新测试结果中的步骤操作。

为测试套件和特定配置创建测试运行

为测试套件和特定配置创建测试运行

  1. 打开一个 Visual Studio 命令提示符。

    为此,请选择**“开始”,指向“所有程序”,指向“Microsoft Visual Studio 2012”,指向“Visual Studio 工具”,然后选择“开发人员命令提示”**。

    命令提示打开文件夹:<驱动器>:\Program Files\Microsoft Visual Studio 11.0\VC

  2. 若要对测试套件中的所有测试创建测试运行,请使用下表中的信息作为特定的测试配置。

    Id

    Planid

    1

    Suiteid

    5

    Configid

    13

    在命令提示符处键入以下内容:

    tcm run /create /title:"Nightly Run" /planid:1 /suiteid:5 /configid:13 /settingsname:"<Name of your automated test settings>" /testenvironment:"<Name of a matching environment>" /collection:<CollectionURL> /teamproject:<Team Project name>

    你将看到类似如下的结果:

    Run created with ID: <xxx>.

    备注

    必须使用 tcm.exe 为自动测试运行提供测试设置和与测试设置中的角色集匹配的环境。有关测试设置和环境的更多信息,请参见设置测试计算机以运行测试或收集数据。若要创建测试设置,请参见使用 Microsoft 测试管理器为自动系统测试创建测试设置

  3. 若要查看测试运行的进度,请按照查看和更新测试结果中的步骤操作。

查看和更新测试结果

查看和更新测试结果

  1. 打开 Microsoft 测试管理器。

    备注

    若要显示 Microsoft 测试管理器 窗口中,请选择“开始”,然后选择“所有程序”。指向 Microsoft Visual Studio 2012,然后选择 Microsoft 测试管理器。

  2. 若要查看测试结果,请选择中心组切换器上的下箭头,然后选择**“测试中心”**。

  3. 在中心组菜单栏上,选择**“测试”,然后选择“分析测试运行”**。

    此时将显示**“分析测试运行”**活动,其中包含此测试计划的所有测试运行。

  4. 打开带有你在命令行中指定的标题的测试运行以打开并查看详细信息。

    此时将显示该测试运行的详细信息。

  5. (可选)若要更新测试运行的标题,请在**“标题”**中键入新名称。

  6. (可选)如果测试未通过,可以更新未通过的原因。 选择**“解决方法”**,然后从列表中选择未通过的原因。

  7. (可选)若要向测试结果添加注释,请选择“注释”图标。 键入你的注释,然后选择**“保存注释”**。

  8. (可选)若要查看单个测试的详细信息,请打开该测试。

    此时将显示测试结果,其中包含该测试运行的详细信息以及该测试的测试结果历史记录。 你可以关闭此视图以返回到测试运行。

    备注

    如果你经过分析确定存在 Bug,则可以从此视图创建 Bug。

  9. 若要保存对该测试运行的这些更改,请在工具栏中选择**“保存”**。

请参见

参考

tcm:列出测试计划、测试套件、测试配置和环境

tcm:使用命令行实用工具从测试计划运行测试

概念

从命令行运行自动测试

其他资源

使用 Team Web Access 计划手动测试