執行手動測試

TCM 命令行工具的必要條件

執行 TCM 指令時，請指定 /collection 和 /teamproject 參數，並視需要指定 /login。

恢復已暫停的測驗

當你回到暫停的手動測試 時，恢復 是預設的操作。 選擇 「繼續」 ，從暫停測試的步驟繼續。

如果你選擇其他暫停測試的動作，Azure Test Plans 會顯示警告，繼續執行該動作可能會丟棄你儲存的進度。 在繼續前請先閱讀警告內容。

使用 TCM 執行測試

您可以使用測試案例管理（TCM）命令列工具執行屬於測試計畫的一部分的測試。 此工具可讓您建立並啟動測試回合，然後管理所有現有的測試回合。 使用這裡記載的 tcm 命令來完成這些工作。

列出測試回合 | 創建測試回合 | 執行測試回合 | 中止測試回合 | 刪除測試回合 | 匯出測試回合 | 發布測試回合

列出測試回合

用來 tcm run /list 列出測試計劃中可用的回合，並顯示其 標識碼。 ID 對應於你建立執行時定義的工作項目 ID。

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

如需了解/collection、/teamproject和/login 參數的詳細描述，請參閱使用 TCM 命令列工具。

範例

下列命令會列出在 fabrikamprime 組織中主辦的 Fabrikam Fiber 專案所定義的測試執行。 識別碼和標題對應於為測試回合定義的工作項目識別碼和標題。 例如，測試運行 1000052 的標題為「循環一測試計畫（手動）」。

tcm run /list /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"

Id        Title                              Owner               Date Completed
--------- ---------------------------------- ------------------- -----------
1000006   Sprint 2 (Manual)                  Jamal Hartnett      1/5/2026
1000032   33 : Change initial view (Manual)  Christie Church     1/11/2026
1000040   Sprint 2 (Manual)                  Jamal Hartnett      1/16/2026
1000042   Sprint 3 (Manual)                  Jamal Hartnett      1/16/2026
1000046   Special testing (Manual)           Francis Totten      1/18/2026
1000052   Test Plan for Cycle 1 (Manual)     Chuck Reinhart      2/1/2026
1000060   Game Shopping (Manual)             Chuck Reinhart      2/6/2026

建立測試回合

使用 tcm run /create 建立與指定測試計劃相關聯的測試回合。 除了測試計畫外，請依照對應 的 ID 指定你想使用的測試套件和設定。 使用 tcm plans /list、 tcm suites /list和 tcm configs /list 指令來收集這些 ID。

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]

如需了解/collection、/teamproject和/login 參數的詳細描述，請參閱使用 TCM 命令列工具。

範例

以下指令會在測試計畫中建立一個名為 MyTestRun 的測試執行，並帶有 ID77。 這個測試使用帶有 ID161 的測試套件和帶有 ID9 的測試配置。 此執行是針對 fabrikamprime 組織中裝載的 Fabrikam Fiber 專案所定義。

在此範例中，測試執行的 ID 為 1000082。

tcm run /create /title:MyTestRun /planid:77 /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber" /suiteid:161 /configid:9

Run created with ID: 1000082.

執行測試回合

使用 tcm run /execute 來啟動測試計畫中的一個執行。 你指定的 ID 對應於你建立執行時定義的工作項目 ID。 要查看所有測試執行識別碼的清單，請使用 tcm run /list 指令。

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

如需了解/collection、/teamproject和/login 參數的詳細描述，請參閱使用 TCM 命令列工具。

範例

以下指令啟動 Fabrikam 光纖專案的 1000082 測試執行，該專案由 fabrikamprime 組織承載。 結果會出現在你的 CLI 視窗中。

tcm run /execute /id:1000082 /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"

Executing run: MyTestRun

Results
------------------------
Total:                   2
Passed:                  1
Failed:                  1
Inconclusive:            0

中止測試回合

用 tcm run /abort 來取消正在進行的測試。 你指定的 ID 對應於你建立執行時定義的工作項目 ID。

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

如需了解/collection、/teamproject和/login 參數的詳細描述，請參閱使用 TCM 命令列工具。

範例

以下指令可停止使用 Fabrikam Fiber 專案 1000082 的測試運行，該專案由 fabrikamprime 組織承載。 結果確認了取消賽事的 編號 與 標題 。

tcm run /abort /id:1000082 /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"

Run with ID [1000082] and title [MyTestRun] has been aborted.

刪除測試回合

使用 tcm run /delete 從測試計劃中刪除測試回合。 您指定的識別碼會對應至建立測試回合時所定義的工作項目識別碼。

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

如需了解/collection、/teamproject和/login 參數的詳細描述，請參閱使用 TCM 命令列工具。

範例

以下指令可刪除 Fabrikam Fiber 專案 1000082 的測試運行，該專案由 fabrikamprime 組織承載。 系統會提示使用者確認他們想要刪除指定的測試回合，並提供結果。

tcm run /delete /id:1000082 /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"

Are you sure you want to delete run [MyTestRun]? (Yes/No) y

Run [MyTestRun] has been deleted.

匯出測試回合

使用 tcm run /export 將測試回合匯出至指定的位置。 您指定的識別碼會對應至建立執行時所定義的工作項目識別碼。

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

如需了解/collection、/teamproject和/login 參數的詳細描述，請參閱使用 TCM 命令列工具。

範例

以下指令將 ID 為 ID 的 1000082 專案測試執行從 fabrikamprime 組織匯出至 。

tcm run /export /id:1000082 /resultsfile:"c:\temp\ResultsForDeveloper.trx" /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"

發佈測試回合

使用 tcm run /publish 來發布指定測試計畫的Visual Studio測試結果檔案結果。

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

如需了解/collection、/teamproject和/login 參數的詳細描述，請參閱使用 TCM 命令列工具。

範例

以下指令會發布帶有 ID161 的測試套件與帶有 ID9 的測試組態的測試執行，並重新指派擁有者。 此指令會更新與此配置配對的測試套件中現有測試案例的測試點，並將結果發佈在指定的 .trx 檔案中。 該指令會將測試執行中失敗的任何測試指派給指定的使用者。

tcm run /publish /suiteid:167 /configid:9 /resultowner:"Jamal Hartnett" /resultsfile:"c:\temp\ResultsForDeveloper.trx" /assignfailurestouser:"Chuck Reinhart" /collection:https://fabrikamprime.visualstudio.com /teamproject:"Fabrikam Fiber"