Destroy 命令 (Team Foundation Build)
您可以使用 TFSBuild destroy 命令，永久終結完成的組建。 您可終結過時的已完成組建以節省資料倉儲中的空間。
警告
請小心使用這個命令，因為您無法回復其作用。
這個命令會永久刪除組建的資料庫記錄，但不會刪除與組建相關的成品，例如置放、版本控制標籤和測試結果。 您可以使用 TFSBuild delete 命令，在永久終結組建之前刪除成品。
必要的使用權限
若要使用 destroy 命令，您必須將 [終結組建] 權限設定為 [允許]。 這個使用權限會自動指定給 Team 專案集合管理員、專案系統管理員和產生器。 如需詳細資訊，請參閱Team Foundation Server 使用權限。
TFSBuild destroy /collection:TeamProjectCollectionUrl /BuildDefinition:DefinitionSpec BuildNumber [BuildNumber...] [/noprompt] [/silent] [/preview]
TFSBuild destroy /collection:TeamProjectCollectionUrl BuildUri [BuildUri...]
TFSBuild destroy TeamProjectCollectionUrl TeamProject BuildNumber [BuildNumber...]
TFSBuild destroy /collection:TeamProjectCollectionUrl /DateRange: [Date]~[Date] /BuildDefinition:DefinitionSpec
TFSBuild destroy /collection:TeamProjectCollectionUrl BuildUri [BuildUri...]
參數
引數 |
描述 |
|---|---|
TeamProjectCollectionUrl |
Team 專案集合的 URL (例如 http://myserver:8080/tfs/DefaultCollection)，該集合包含您要終結的組建。 |
DefinitionSpec |
搭配 /BuildDefinition 使用。 您想要終結的組建定義。 可以使用萬用字元。 |
BuildNumber |
您所要終結之一個或多個組建的空格分隔清單。 如果組建編號具有空格，請以單引號括住編號。 可以使用萬用字元。 |
BuildUri |
您所要終結之組建的 URI 的空格分隔清單。 |
TeamProject |
此組建定義所在的 Team 專案名稱。 |
Date |
用於 /daterange 選項。 .NET Framework 可以剖析的任何格式的日期。 您可以使用 "~" 指定日期範圍，如下列範例所示：
|
選項 |
描述 |
|---|---|
/collection |
指定 Team 專案集合。 |
/BuildDefinition |
指定一個或多個您想要刪除的組建定義。 |
/preview |
在 [命令提示字元] 視窗中顯示可能終結的組建。 當您指定這個選項時，不會實際終結組建。 |
/noprompt |
指定不要在您即將刪除組建時提示您。 |
/silent |
指定不要在刪除組建時將輸出寫入 [命令提示字元] 視窗中。 暗示 /noprompt。 |
備註
如果沒有適當的使用權限而嘗試終結組建，則會出現對話方塊通知您該事實。
範例
下列範例會永久終結早於 2010 年 11 月 20 日且以 "New Works" Team 專案中的 "Nightly Build" 組建定義為基礎的組建。
>tfsbuild.exe destroy /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"New Works\Nightly Build" /daterange:~2010-11-20