共用方式為


Start 命令 (Team Foundation Build)

更新:2007 年 11 月

使用 start 命令可以執行已設定的 Team Foundation Build 組建定義。

必要的使用權限

您必須將 Team Foundation Server 的 [啟動組建] 安全性權限設定為 [允許],才能使用 start 命令。此外,應用程式層服務帳戶和 Team Foundation Build 服務帳戶對於組建放置位置必須有讀取/寫入權限。如需詳細資訊,請參閱 Team Foundation Server 使用權限

注意事項:

即使您已使用管理認證登入,還是必須開啟較高權限的命令提示字元,在執行 Windows Server 2008 的伺服器上執行此函式。若要開啟較高權限的命令提示字元,請按一下 [開始],以滑鼠右鍵按一下 [命令提示字元],再按一下 [以系統管理員身分執行]。如需詳細資訊,請參閱 Microsoft 網站 (英文)。

TFSBuild start /server:teamFoundationServer 
/builddefinition:definitionSpec [/droplocations:dl] [/getoption:go] 
[/customgetversion:versionSpec] [/priority:p] [/requestedfor:userName] 
[/msbuildarguments:args] [/silent] [/queue]

TFSBuild start teamFoundationServer teamProject definitionName 
[/droplocation:dl] [/getoption:go] [priority:p]
  [/customversion:versionSpec] [/requestedfor:userName]
[/msbuildarguments:args] [/silent] [/queue]

參數

引數

描述

teamFoundationServer

簽入建置中方案的 Team Foundation 伺服器 URL。

teamProject

建置方案的 Team 專案名稱。

definitionName

Team 專案中用於組建的組建定義名稱。

dl

公用資料夾的路徑,組建完成後會將組建二進位檔和記錄檔儲存在該資料夾中。例如,//server/share。這會搭配 /droplocations 選項使用。

go

搭配 /getoption 選項使用。只要在值為 LatestOnQueue、LatestOnBuild 和 Custom 的位置就有效。

versionSpec

/getoption 設為 Custom 時,要建置的檔案版本。這會搭配 /customgetversion 選項使用。

您可以藉由下列各項指定版本:

  • 日期/時間 (D10/20/2005)

  • 變更集版本 (C1256)

  • 標籤 (Lmylabel)

  • 最新的版本 (T)

  • 工作區版本 (Wworkspacename;owner)

p

用於組建定義的佇列優先順序。這會搭配 /priority 選項使用。

有效的值包括:Low、BelowNormal、Normal、AboveNormal 和 High。

userName

要求組建的使用者。

args

傳遞至 MSBuild 的命令列引數。

選項

描述

/droplocation

選擇項,指定組建流程發生的目錄。這個目錄可縮寫成 /d。根據預設,會使用組建定義中指定的組建目錄。

注意事項:

選擇組建目錄時,務必確定建置的空間足夠,因為空間不足將導致取消組建。

/getoption

選擇項,指定從版本控制取得的檔案。

/customgetversion

選擇項,如果 /getoption 的值指定為 Custom,則指定要取得的自訂檔案版本。

/priority

選擇項,指定組建佇列優先順序。

/requestedfor

選擇項,指定要求組建的對象。

/msbuildarguments

選擇項,指定傳遞至 MSBuild 的命令列引數。

一般格式為:

/msbuildarguments:"/p:SomeProperty=SomeValue /t:MySpecialTarget"

/silent

選擇項,當您指定這個選項時,輸出不會在組建執行期間寫入 [命令提示字元] 視窗。

/queue

將組建啟動要求插入組建佇列中,並且立即傳回。

備註

您可以使用 Team Foundation 命令列的 TFSBuild start 命令搭配工作排程器服務,執行週期性或每晚的組建。

如果您要建置一個以上的方案,請在決定建置順序時,考慮讓方案彼此具有相依性。例如,當 Solution2 相依於 Solution1 時,要先建置 Solution1,然後再建置 Solution2。

根據預設,置放目錄不會自動建立為共用資料夾。因此,無法用來發行組建和測試結果。您必須手動建立共用資料夾,然後將寫入權限加入至 Windows 目錄,並針對用來執行 Team Build 服務以置放組建的帳戶,以及發行測試結果的測試人員帳戶加入共用權限。

範例

下列範例會建置 Nightlies 組建類型,而此組建類型位於 server01 上的 AdventureWorks Team 專案中。產生的組建位於 BuildDrop 目錄中。

>TFSBuild start http://server01:8080 /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"

下列範例會建置 Nightlies 組建類型,而此組建類型位於 server01 上的 AdventureWorks Team 專案中。產生的組建位於 BuildDrop 目錄中。使用 /msbuildarguments 選項傳遞診斷的 MSBuild 詳細等級。如需詳細資訊,請參閱 MSBuild 命令列參考

>TFSBuild start http://server01:8080 /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"

請參閱

工作

HOW TO:從命令列啟動組建

HOW TO:建立組建定義

其他資源

Team Foundation Build 命令

在 Team Foundation Build 中執行組建

在 Team Foundation Build 中使用組建定義