共用方式為


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 可以剖析的任何格式的日期。 您可以使用 "~" 指定日期範圍,如下列範例所示:

  • ~1/1/2010 – 在 2010 年 1 月 1 日之前建立的所有組建

  • 1/1/2010~ – 在 2010 年 1 月 1 日之後建立的所有組建

  • 1/1/2009~12/31/2009 – 在 2009 年 1 月 1 日和 2009 年 12 月 31 日之間建立的所有組建

選項

描述

/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

請參閱

工作

刪除已完成的組建

建立基本組建定義

其他資源

Team Foundation Build 命令

執行和監視組建

定義您的建置流程