共用方式為

Delete 命令 (Team Foundation Build)

  • 發行項

您可以使用 delete 命令來刪除已完成的組建，包括一些或所有相關的資料。

注意事項注意事項

這個命令不會刪除倉儲中的資料。若要執行這種作業，請使用 destroy 命令。 如需詳細資訊，請參閱Destroy 命令 (Team Foundation Build)。

必要的使用權限

若要執行 delete 命令，要求刪除作業的帳戶必須將 [刪除組建] 權限設定為 [允許]。 如果所刪除的組建有相關聯的測試結果，此帳戶必須將 [發行測試結果] 權限設定為 [允許]。 此外，應用程式層服務帳戶和 Team Foundation Build 服務帳戶對於組建置放位置必須有讀取/寫入權限。 如需詳細資訊，請參閱Team Foundation Server 使用權限。

TFSBuild delete /collection:teamProjectCollectionUrl /builddefinition:definitionSpec buildnumber[buildNumber...] [/deleteOptions:deleteOptions] [/noprompt] [/silent] [/preview] 

TFSBuild delete /collection:teamProjectCollectionUrl buildUri[buildUri...]

TFSBuild delete teamProjectCollectionUrl teamProject buildNumber[buildNumber...]

TFSBuild delete /collection:teamProjectCollectionUrl /dateRange:[date]~[date] /buildDefinition:definitionSpec

TFSBuild delete /collection:teamProjectCollectionUrl /dateRange:[date]~[date] teamProject

參數

引數

描述

teamProject

此組建定義所在的 Team 專案名稱。

definitionSpec

搭配 /builddefinition 使用。 您想要刪除的一個或多個組建。 支援萬用字元。

buildNumber

您所要刪除之一個或多個組建的空格分隔清單。 如果組建編號具有空格，請以單引號括住編號。 支援萬用字元。

buildUri

您所要刪除之組建的 URL 的空格分隔清單。

teamProjectCollectionUrl

Team 專案集合的 URL (例如 http://myserver:8080/tfs/DefaultCollection)，該集合包含您要刪除的組建。

deleteOptions

使用者提供給 /deleteOptions 選項的值。 若要刪除組建，您可以指定下列其中一個或多個選項：

  • DropLocation – 刪除組建的置放位置。

  • TestResults – 刪除組建的測試結果。

  • 標籤 – 刪除由組建所建立的版本控制標籤。

  • 詳細資料 - 刪除組建的詳細資料 (例如活動記錄檔)。

  • 符號 – 刪除在與組建相關聯的符號存放區中的任何符號檔 (*.pdb)。

  • 所有 – 刪除與組建相關聯的所有資料。

    注意事項注意事項
    您可以使用逗號來分隔選項。例如，您可以使用 "/deleteOptions: DropLocation, Symbols" 刪除組建的置放和符號。

date

/daterange 選項的使用者提供值。 您可以使用 "~" 指定日期範圍，如下列範例所示：

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

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

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

選項

描述

/noprompt

請勿在刪除組建時提示。

/silent

請勿在刪除時將輸出寫入 [命令提示字元] 視窗中。 暗示 /noprompt。

/builddefinition

指定一個或多個您想要刪除的組建定義。

/collection

指定 Team 專案集合。

/deleteOptions

指定刪除組建的選項。

/preview

顯示可能發生的狀況，而不需實際執行 delete 作業。

/daterange

指定您想要刪除的組建的日期範圍。

備註

刪除程序

如果在進行此程序的期間發生失敗，就會出現警告訊息。 但是，即使出現警告，依然會將刪除視為成功。

刪除多重組建

如果您指定多個組建，在刪除其中一個組建時失敗並不會停止此程序。 在提供組建刪除失敗的錯誤訊息後，此命令會繼續刪除其他組建。

事件記錄檔

組建刪除作業會記錄在事件記錄檔中。 此記錄檔將會包含一些相關資訊，包括刪除此組建的人員、刪除此組建的時間，以及組建編號。

範例

下列範例會從位於 http://myserver:8080/tfs/DefaultCollection 之 Team 專案集合內的 AdventureWorks Team 專案中，刪除組建編號 "TestBuild1 1_20070510.1" 和 "TestBuild 1_20070510.2" 所定義的兩個組建。

> > tfsbuild.exe delete http://myserver:8080/tfs/DefaultCollection Adventureworks "TestBuild1 1_20070510.1" "TestBuild 1_20070510.2"

下列範例會從位於 http://myserver:8080/tfs/DefaultCollection 之 Team 專案集合內的 AdventureWorks Team 專案中，刪除兩個特定組建，其中 definitionSpec 是 "\Adventureworks\Definition1"。

>tfsbuild.exe delete /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"\Adventureworks\Definition 1" "Definition 1_20070510.1" "Definition 1_20070510.2"

下列範例會從位於 http://myserver:8080/tfs/DefaultCollection 之 Team 專案集合內的 AdventureWorks Team 專案中，刪除組建 URI "vstfs:///TestBuild/TestBuild/1" 和 "vstfs:///TestBuild/TestBuild/2" 所定義的兩個組建。

>tfsbuild.exe delete /collection:http://myserver:8080/tfs/DefaultCollection vstfs:///TestBuild/TestBuild/1 vstfs:///TestBuild/TestBuild/29

請參閱

工作

刪除已完成的組建

其他資源

Destroy 命令 (Team Foundation Build)