Start 命令 (Team Foundation Build)
使用 start 命令可以執行已設定的 Team Foundation Build 組建定義。
必要的使用權限
若要使用 start 命令，您必須將 Visual Studio Team Foundation Server 中的 [佇列組建] 和 [檢視組建定義] 安全性權限設定為 [允許]。 此外，應用程式層服務帳戶和 Team Foundation Build 服務帳戶對於組建放置位置必須有讀取/寫入權限。如需詳細資訊，請參閱 Team Foundation Server 使用權限。
TFSBuild start /collection:teamProjectCollectionUrl
/builddefinition:definitionSpec [/droplocation:droplocation] [/getoption:getoption]
[/customgetversion:versionSpec] [/priority:priority] [/requestedfor:userName]
[/msbuildarguments:args] [/shelveset:shelvesetName [/checkin]]
[/silent] [/queue]
TFSBuild start teamProjectCollectionUrl teamProject definitionName
[/droplocation:droplocation] [/getoption:getoption] [priority:priority]
[/customgetversion:versionSpec] [/requestedfor:userName]
[/shelveset:shelvesetName [/checkin]]
[/msbuildarguments:args] [/silent] [/queue]
參數
引數 |
描述 |
|---|---|
teamProjectCollectionUrl |
包含建置中解決方案和專案之 Team 專案集合的 URL。 |
teamProject |
包含所建置解決方案和專案之 Team 專案的名稱。 |
definitionName |
Team 專案中要用於組建的組建定義名稱。 |
droplocation |
公用資料夾的路徑，在組建完成後，組建的二進位檔和記錄檔便會儲存在其中。 例如，\\server\share。 這會搭配 /droplocation 選項使用。 |
getoption |
搭配 /getoption 選項使用。 有效的值包括 LatestOnQueue、LatestOnBuild 和 Custom。 |
versionSpec |
|
priority |
用於組建定義的佇列優先順序。 您可以搭配使用這個引數與 /priority 選項。 有效的值包括 Low、BelowNormal、Normal、AboveNormal 和 High。 |
userName |
您要使其與完整的組建相關聯之使用者的名稱。 |
args |
傳遞至 MSBuild 的命令列引數。 |
shelvesetName |
指定擱置集的名稱，如果您想要開始私用組建，或是開始以閘道簽入觸發程序定義的組建。 |
選項 |
描述 |
|---|---|
/collection |
指定 Team 專案集合。 |
/droplocation |
選擇項。 指定組建流程發生的目錄。 這個目錄可縮寫成 /d。 根據預設，會使用組建定義中指定的組建目錄。 .gif "注意事項") 注意事項
當您選取組建目錄時，務必確定建置空間足夠，因為空間不足將導致取消組建。
|
/getoption |
選擇項。 指定您想要從版本控制取得的檔案。 |
/customgetversion |
選擇項。 指定您想要取得之檔案的自訂版本，如果您將 /getoption 的值指定為 Custom。 |
/priority |
選擇項。 指定組建佇列優先順序。 |
/requestedfor |
選擇項。 指定要求組建的對象。 |
/msbuildarguments |
選擇項。 指定傳遞至 MSBuild 的命令列引數。 一般格式為： /msbuildarguments:"/p:SomeProperty=SomeValue /t:MySpecialTarget" |
/shelveset |
選擇項。 指定擱置集的名稱，如果您想要開始私用組建，或是開始以閘道簽入觸發程序定義的組建。 |
/checkin |
選擇項。 您必須啟動已定義閘道簽入觸發的組建，才能使用此選項。 如果您想要系統在組建成功時簽入檔案，請指定這個選項。 |
/silent |
選擇項。 當您指定這個選項時，就不會在組建執行時將輸出寫入 [命令提示字元] 視窗。 |
/queue |
將組建的啟動要求插入組建佇列中，並且立即傳回。 |
備註
您可以使用 Team Foundation 命令列的 TFSBuild start 命令搭配工作排程器服務，執行週期性或每晚的組建。
如果您要建置一個以上的方案，請在決定建置順序時，考慮讓方案彼此具有相依性。 例如，當 Solution2 相依於 Solution1 時，要先建置 Solution1，然後再建置 Solution2。
根據預設，置放目錄不會自動建立為共用資料夾。 因此，無法將它用於發行組建和測試結果。 您必須手動建立共用資料夾，然後將寫入權限加入至 Windows 目錄，並針對用來執行 Team Build 服務以置放組建的帳戶，以及發行測試結果的測試人員帳戶加入共用權限。
範例
下列範例會建置 Nightlies 組建類型，這個類型是在位於 http://myserver:8080/DefaultCollection 之 Team 專案集合內的 AdventureWorks Team 專案中。 產生的組建位於 BuildDrop 目錄中。
>TFSBuild start http://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops"
下列範例會建置 Nightlies 組建類型，這個類型是在位於 http://myserver:8080/DefaultCollection 之集合內的 AdventureWorks Team 專案中。 產生的組建位於 BuildDrop 目錄中。 使用 /msbuildarguments 選項傳遞診斷的 MSBuild 詳細等級。 如需詳細資訊，請參閱 MSBuild 命令列參考。
>TFSBuild start http://myserver:8080/DefaultCollection /builddefinition:"AdventureWorks\Nightlies" /droplocation:"\\computername\buildDrops" /msbuildarguments:"/flp:verbosity=diag"