Delete 命令 (Team Foundation Build)
更新：2007 年 11 月
delete 命令會刪除指定的已完成組建。所有與組建相關的資料都會從組建代理程式和版本控制中刪除，同時會清除置放位置。此外，組建將不再列於 [Build 總管] 中。
必要的使用權限
若要執行 delete 命令，要求刪除作業的帳戶必須將 [管理組建] 權限設定為 [允許]。如果所刪除的組建有相關聯的測試結果，此帳戶必須將 [發行測試結果] 權限設定為 [允許]。此外，應用程式層服務帳戶和 Team Foundation Build 服務帳戶對於組建置放位置必須有讀取/寫入權限。如需詳細資訊，請參閱 Team Foundation Server 使用權限。
.gif "注意事項") 注意事項： |
|---|
即使您已使用管理認證登入，還是必須開啟較高權限的命令提示字元，在執行 Windows Server 2008 的伺服器上執行此函式。若要開啟較高權限的命令提示字元，請按一下 [開始]，以滑鼠右鍵按一下 [命令提示字元]，再按一下 [以系統管理員身分執行]。如需詳細資訊，請參閱 Microsoft 網站 (英文)。 |
TFSBuild delete [/noprompt] [/silent] /server:teamFoundationServer /builddefinition:definitionSpec buildNumbers…
TFSBuild delete [/noprompt] [/silent] /server:teamFoundationServer buildUris…
TFSBuild delete [/noprompt] [/silent] teamFoundationServer teamProject buildNumbers…
參數
引數 |
描述 |
|---|---|
teamfoundationserver |
用於組建的 Team Foundation 伺服器 URL。 |
teamProject |
此組建定義所在的 Team 專案名稱。 |
definitionSpec |
搭配 /builddefinition 使用。要刪除的組建。支援萬用字元。 |
BuildNumbers |
要刪除的空格分隔組建清單。如果組建編號含有空格，就必須以單引號包圍此編號。支援萬用字元。 |
buildUris |
要刪除之組建的空格分隔組建 URI 清單。 例如，tfsbuild delete uri1 uri2 uri3 /s:MyServer。 |
選項 |
描述 |
|---|---|
/noprompt |
選擇項，刪除組建時不發出提示。 |
/silent |
選擇項，請勿在刪除時將輸出寫入 [命令提示字元] 視窗中。暗示 /noprompt。 |
/server |
要刪除的組建所使用的 Team Foundation 伺服器。 |
/builddefinition |
指定要刪除的組建定義。 |
備註
刪除程序
當您刪除組建編號時，請依照下列步驟執行：
確認組建編號有效，且組建並未處於進行中狀態。
如果要求者擁有 [管理組建] 使用權限，則刪除組建存放區和置放區的內容。
清除此組建二進位檔的置放位置。如果此程序進行期間發生錯誤，則會出現警告訊息提示您。不過，即使出現警告，刪除作業仍視為成功。
注意事項：不會刪除倉儲中的任何資料。
刪除多重組建
如果您指定多個組建，在刪除其中一個組建時失敗並不會停止此程序。在提供組建刪除失敗的錯誤訊息後，此命令會繼續刪除其他組建。
事件記錄檔
組建刪除作業會記錄在事件記錄檔中。此記錄檔將會包含一些相關資訊，包括刪除此組建的人員、刪除此組建的時間，以及組建編號。
範例
以下範例將從 server01 上的 AdventureWorks Team 專案刪除組建編號 "TestBuild1 1_20070510.1" 和 "TestBuild 1_20070510.2" 所定義的兩個組建。
> > tfsbuild.exe delete http://server01:8080 Adventureworks “TestBuild1 1_20070510.1” “TestBuild 1_20070510.2”
以下範例將刪除兩個特定組建，其中 definitionSpec 是 server01 上 AdventureWorks Team 專案的 "\Adventureworks\Definition1"。
>tfsbuild.exe delete /server:http://server01:8080 /builddefinition:”\Adventureworks\Definition 1” “Definition 1_20070510.1” “Definition 1_20070510.2”
以下範例將從 server01 上的 AdventureWorks Team 專案刪除組建 URI "vstfs:///TestBuild/TestBuild/1" 和 "vstfs:///TestBuild/TestBuild/2" 所定義的兩個組建。
>tfsbuild.exe delete /server:http://server01:8080 vstfs:///TestBuild/TestBuild/1 vstfs:///TestBuild/TestBuild/29