Start 命令 (Team Foundation Build)
更新：2007 年 11 月
使用 start 命令可以執行已設定的 Team Foundation Build 組建定義。
必要的使用權限
您必須將 Team Foundation Server 的 [啟動組建] 安全性權限設定為 [允許]，才能使用 start 命令。此外，應用程式層服務帳戶和 Team Foundation Build 服務帳戶對於組建放置位置必須有讀取/寫入權限。如需詳細資訊，請參閱 Team Foundation Server 使用權限。
.gif "注意事項") 注意事項： |
|---|
即使您已使用管理認證登入，還是必須開啟較高權限的命令提示字元，在執行 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 選項使用。 您可以藉由下列各項指定版本：
|
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"