共用方式為

tcm：使用命令列公用程式執行測試計劃中的測試

  • 發行項

您可以從命令列執行屬於測試計劃一部分的自動化測試。這可讓您使用批次檔啟動測試回合，以便您對回合進行排程。您還可以從命令列管理測試回合。如果您想要匯出測試回合，讓開發人員可以使用 Visual Studio 檢視測試結果，您可以使用 tcm 達到此目的。您還可以使用 tcm，發行 Visual Studio 測試回合檔案 (.trx) 中的測試回合結果。您可以指定將此測試回合檔案中的所需結果重新發行至您的測試計劃。您可以使用下列 tcm 命令完成這些工作：

  • tcm run /create

  • tcm run /list

  • tcm run /execute

  • tcm run /abort

  • tcm run /delete

  • tcm run /export

  • tcm run /publish

tcm.exe 位於 <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE 搭配 Visual Studio Ultimate， Visual Studio Premium，或 Visual Studio Test Professional 試用版安裝的電腦。

如需如何將自動化測試匯入至測試專案並設定專案計劃以執行這些測試的詳細資訊，請參閱從自動化測試的組件建立測試案例和 HOW TO：使用 Tcm 從命令列執行自動化測試。

tcm run /create /title:title /planid: id /collection:CollectionURL /teamproject:project (suiteid:id /configid:configid | /querytext: query) [/settingsname:name] [/owner:owner] [/builddir:directory]  [/testenvironment:name] [/login:username,[password]] [/include]

tcm run /execute /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]]

tcm run /list [/planid:id | /querytext: query] /collection:CollectionURL /teamproject:project [/login:username,[password]]

tcm run /abort /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]]

tcm run /delete /id:id /collection:CollectionURL /teamproject:project [/login:username,[password]] [/noprompt]

tcm run /export /id:id /resultsfile:path /collection:CollectionURL /teamproject:project [/login:username,[password]] [/attachment:attachmentname]

tcm run /publish /suiteid:id /configid:id /resultowner:owner /resultsfile:path /collection:CollectionURL /teamproject:project    [/title: runtitle] [/runowner:owner] [/build:buildnumber /builddefinition:builddefinition] [/flavor:flavor [/platform:platform]  [/assignfailurestouser:user] [/login:username,[password]] [/buildverification]

參數

參數

描述

/collection:CollectionURL

指定 Team 專案集合的 URI。URI 的格式如下：http://ServerName:Port/VirtualDirectoryName/CollectionName

如果不使用任何虛擬目錄，則 URI 格式如下：

http://ServerName:Port/CollectionName

/teamproject:project

Team 專案的名稱，此 Team 專案包含您要將自動化測試匯入其中的測試計劃。

/title: title

指定要用於您所建立之回合的標題，或指定是否發行測試回合檔案。

/planid:id

指定包含所要執行之測試的計劃，或指定與所要列出之測試回合相關聯的計劃。

/suiteid:id

指定您要執行的測試套件。

您也可以指定要在發行測試回合時使用的測試套件。

注意事項注意事項
若要找出套件 ID，您可以列出測試計劃的測試套件。如需詳細資訊，請參閱tcm：列出測試計劃、測試套件、測試組態和環境。
提示提示
若要執行多個測試套件，您可以使用/querytext 參數。

/configid:configid

指定要為測試套件執行哪些測試組態。

您也可以指定要在發行測試回合時使用的測試組態。

提示提示
若要執行一個以上的測試組態，您可以使用/querytext 參數。

/querytext:query

指定要用於傳回測試回合的查詢，或指定要用於選取所需執行之測試的查詢。

提示提示
您可以使用/querytest 參數執行一個以上的測試套件。例如：querytext:“SELECT * FROM TestPoint WHERE (ConfigurationId=20 OR ConfigurationId=21) AND (Suiteid=1185 OR Suiteid=1186)”

/settingsname:name

選擇項。指定要用於此測試回合的測試設定。如果您沒有使用此參數選取測試設定，則會為測試計劃中的自動化測試使用預設測試設定。

/owner:owner

選擇項。指定測試回合的擁有者。

/runowner:owner

選擇項。指定測試回合的擁有者。

/builddir:directory

選擇項。指定要用於尋找自動化測試之測試組件的組建目錄。如果未指定，則會根據目前指派給測試計劃的組建，使用組建位置。

/testenvironment:name

選擇項。指定要用於此測試回合的測試環境。如果您沒有使用此參數選取測試環境，則會為測試計劃中的自動化測試使用預設測試環境。

/id:id

指定要刪除、中止或匯出的回合 ID。

/resultsfile:path

指定要用於匯出測試回合或在其中尋找要發行之測試回合的位置。例如，"c:\temp\ResultsForDeveloper.trx"。

/attachment:attachmentname

指定您所匯出之測試回合的附件名稱。

/resultowner:owner

指定測試結果的擁有者。

/build:buildnumber

選擇項。指定要用於發行測試回合的組建編號。這個參數必須搭配 /builddefinition 使用。

/builddefinition:builddefinition

選擇項。指定要用於發行測試回合的組建定義。這個參數必須搭配 /build 使用。

/flavor:flavor

選擇項。指定組建類別。例如，Release。只有在 /build 參數已使用時才能使用此參數。

/platform:platform

選擇項。指定組建平台。例如，x86。只有在 /build 參數已使用時才能使用此參數。

/assignfailurestouser:user

選擇項。指定要接受指派測試回合中任何失敗測試的人員。

/buildverification

選擇項。指定此測試回合包含檢查組建基本功能的組建驗證測試。

/include

選擇項。指定所選測試回合的所有測試都包括在內，即使這些測試目前未設定為作用中狀態也一樣。

/noprompt

選擇項。指定不要提示使用者確認刪除測試回合。

/login:username,[password]

選擇項。指定可登入 Team Foundation Server 應用程式層伺服器和有權限執行命令之使用者的名稱和密碼。如果您的 Windows 認證沒有適當的權限，或者您使用基本驗證或未連接到網域，就會使用這個選項。

您可以將 /collection 和 /teamproject 的參數加入至 tcm.exe.config XML 檔案，這個檔案位於和 tcm.exe: <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE 相同的目錄中。如果您將這些加入至檔案，就不需要每次執行 tcm 命令時在命令列上輸入它們。您可以將這些索引鍵及其值加入至檔案的 appSettings 區段中，如下所示：

    <appSettings>
         <add key="TeamFoundationServer" value="http://<ServerName:Port/VirtualDirectoryName/CollectionName>"/>
         <add key ="TeamProject" value="DinnerNow"/>
    </appSettings>

執行測試並管理測試回合

下列範例假設您已經啟動 Visual Studio 命令提示字元。

若要這麼做，請按一下 [開始]，然後依序指向 [所有程式]、[Microsoft Visual Studio 2012]、[Visual Studio Tools]，再按一下 [開發者命令提示字元]。

命令提示字元會開啟至資料夾：<drive>:\Program Files\Microsoft Visual Studio 11.0\VC

將目錄變更為包含從您的測試專案所建置之組件的資料夾。

重要事項重要事項

若要從命令列以 tcm.exe 執行自動化測試，您必須使測試案例與自動化測試產生關聯。如果未在命令列上指定組建資訊，您也必須正確設定測試計劃，才能使用組建找到要執行的自動化測試。如需這個做法的詳細資訊，請參閱 HOW TO：使用 tcm.exe 從自動化測試的組件建立測試案例。

若要取得下列命令所需的 ID，您可能要使用 tcm 列出測試成品及其 ID。如需這個做法的詳細資訊，請參閱 tcm：列出測試計劃、測試套件、測試組態和環境和 HOW TO：使用 Tcm 從命令列執行自動化測試。

下列命令會使用測試點查詢來執行測試：

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>

下列命令會使用特定測試套件和組態來執行測試：

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>

使用特定 ID，下列命令來執行測試:

Tcm run /execute /id:1207 /collection:<CollectionURL> /teamproject:<Team Project name>

下列命令會列出特定測試計劃的測試回合：

tcm run /list /planid:1 /collection:<CollectionURL> /teamproject:<Team Project name>

下列命令會刪除特定測試回合：

tcm run /delete /id:1009 /collection:<CollectionURL> /teamproject:<Team Project name>

下列命令會將測試回合匯出至 .trx 檔案：

tcm run /export /id:1273 /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>

下列命令會發行特定測試套件及測試組態的測試回合，並重新指派擁有者。這會在與此測試組態搭配的測試套件中，將測試案例的現有測試點更新為 .trx 檔案中的結果：

tcm run /publish /suiteid:5 /configid:13 /resultowner:"<Name of new owner>" /resultsfile:"c:\temp\latest.trx" /collection:<CollectionURL> /teamproject:<Team Project name>

請參閱

參考

tcm：列出測試計劃、測試套件、測試組態和環境

其他資源

tcm：從命令列匯入和執行測試計劃的自動化測試