tcm：列出測試計劃、測試套件、測試組態和環境
若要從命令列使用 tcm.exe 執行測試，或是將測試案例匯入至特定測試套件中，您需要執行測試所需成品的 ID 和名稱。 您可以使用下列 tcm 命令，從命令列取得測試成品的清單：
tcm plans /list
tcm suites /list
tcm configs /list
tcm testenvironments /list
tcm.exe 位於任何已安裝 Visual Studio Ultimate、Visual Studio Premium 或 Visual Studio Test Professional 之電腦的 <Drive:>\Program Files\Microsoft Visual Studio 11.0\Common7\IDE。
tcm plans /list [/querytext:query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm suites /list [/planid: id | /querytext:query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm configs /list [/querytext:query] /collection:CollectionURL /teamproject:project [/login:username,[password]]
tcm testenvironments /list /collection:CollectionURL /teamproject:project [/login:username,[password]]
參數
參數 |
描述 |
|---|---|
/querytext:query |
指定要用來傳回測試成品的查詢。 |
/planid:id |
指定只要列出此測試計劃中的測試套件。 |
/collection:CollectionURL |
指定 Team 專案集合的 URI。 URI 的格式如下：http://ServerName:Port/VirtualDirectoryName/CollectionName 如果不使用任何虛擬目錄，則 URI 格式如下： http://ServerName:Port/CollectionName |
/teamproject:project |
Team 專案的名稱，包含您要將自動化測試匯入其中的測試計劃。 |
/login:username,[password] |
選擇項。 指定可登入 Team Foundation Server 應用程式層伺服器和有權限執行命令之使用者的名稱和密碼。 如果您的 Windows 認證沒有適當的權限，或者您使用基本驗證或未連接到網域，就會使用這個選項。 若要登入 Visual Studio Online，您也必須使用下列 /allowalternatecredentials。 |
/allowalternatecredentials |
連接至 Visual Studio Online 時，除了 /login 參數之外，還必須指定這個旗標。 (只有安裝 Visual Studio 2013 Update 4 (含) 以上版本時，才能使用這個旗標)。 |
您可以將 /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
下列命令會列出 DinnerNow Team 專案中的測試組態：
tcm configs /list /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow
下列命令僅列出 DinnerNow Team 專案中的測試計劃衝刺 1 ，以便您檢視其 ID：
tcm plans /list /querytext:"SELECT * FROM TestPlan WHERE PlanName=’Sprint 1’" /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow
下列命令會列出 DinnerNow Team 專案內 ID 為 3 之測試計劃中的測試套件：
tcm suites /list /planid:3 /collection:http://<Team Foundation Server Name>:8080/tfs/<team project collection name>
/teamproject:DinnerNow