手動テストの実行

TCM コマンドライン ツールの前提条件

TCM コマンドを実行するには、 /collection パラメーターと /teamproject パラメーターを指定し、必要に応じて /login します。

一時停止したテストを再開する

一時停止中の手動テストに戻ると、 Resume が既定のアクションになります。 [ 再開 ] を選択して、テストを一時停止した手順から続行します。

一時停止したテストに対して別のアクションを選択した場合、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 プロジェクトに対して定義されているテスト実行の一覧が表示されます。 ID とタイトルは、そのテスト実行に定義されている作業項目 ID とタイトルに対応します。 たとえば、テスト実行 1000052 には、 サイクル 1 のテスト計画 (手動) というタイトルが付けられます。

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 で指定します。 これらの ID を収集するには、 tcm plans /list、 tcm suites /list、および tcm configs /list コマンドを使用 します。

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 コマンド ライン ツールを使用した作業」を参照してください。

例

次のコマンドは、ID を持つテスト 計画に 77 という名前のテスト実行を作成します。 この実行では、ID を持つテスト スイートと161ID を持つテスト構成9を使用します。 この実行は、fabrikamprime 組織でホストされている Fabrikam Fiber プロジェクトに対して定義されます。

この例では、テストの実行には の 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 コマンド ライン ツールを使用した作業」を参照してください。

例

次のコマンドは、fabrikamprime 組織でホストされている 1000082 プロジェクトの ID のテスト実行を開始します。 結果が 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 コマンド ライン ツールを使用した作業」を参照してください。

例

次のコマンドは、fabrikamprime 組織でホストされている 1000082 プロジェクトの ID を使用してテストの実行を停止します。 結果は、取り消された実行の ID と タイトル を確認します。

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 を使います。 指定する ID は、テスト実行の作成時に定義された作業項目 ID に対応しています。

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

/collection、/teamproject、および/login パラメーターについては、「TCM コマンド ライン ツールを使用した作業」を参照してください。

例

次のコマンドは、fabrikamprime 組織でホストされている 1000082 プロジェクトの ID を使用してテスト実行を削除します。 ユーザーは指定したテスト実行を削除する意思の確認を求められ、結果が提供されます。

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 を使います。 指定する ID は、実行の作成時に定義された作業項目 ID に対応しています。

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

/collection、/teamproject、および/login パラメーターについては、「TCM コマンド ライン ツールを使用した作業」を参照してください。

例

次のコマンドは、fabrikamprime 組織でホストされている 1000082 プロジェクトの ID を使用してテスト実行をc:\temp\ResultsForDeveloper.trxにエクスポートします。

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"