Destroy コマンド (Team Foundation ビルド)

TFSBuild destroy コマンドを使用して、 完了したビルドを永続的に破棄することができます。 完了したビルドのうち、古くなったものを破棄することで、データ ウェアハウスの領域を確保することができます。

ヒント

破棄した結果を元に戻すことはできないので、このコマンドは慎重に使用してください。

このコマンドでは、ビルドのデータベース レコードが完全に削除されますが、ドロップ、バージョン コントロール ラベル、テスト結果など、ビルドに関係する成果物は削除されません。 TFSBuild delete コマンドを使用して、成果物を削除してからビルドを永続的に破棄することができます。

必要なアクセス許可

destroy コマンドを使用するには、[ビルドの破棄] のアクセス許可が [許可] に設定されている必要があります。 このアクセス許可は、チーム プロジェクト コレクション管理者、プロジェクト管理者、およびビルダーに自動的に付与されます。 詳細については、「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

破棄するビルドを含むチーム プロジェクト コレクションの URL (http://myserver:8080/tfs/DefaultCollection など)。

DefinitionSpec

/BuildDefinition で使用されます。 破棄するビルド定義。 ワイルドカード文字も使用できます。

BuildNumber

破棄するビルドのスペース区切りのリスト。 ビルド番号に空白が含まれる場合は、空白を単一引用符で囲んでください。 ワイルドカード文字も使用できます。

BuildUri

破棄するビルドの URI のスペース区切りのリスト。

TeamProject

このビルド定義が含まれるチーム プロジェクト名。

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

チーム プロジェクト コレクションを指定します。

/BuildDefinition

削除するビルド定義を指定します。

/preview

破棄されるビルドをコマンド プロンプト ウィンドウに表示します。 このオプションを指定しても、ビルドは実際には破棄されません。

/noprompt

ビルドを削除するときにプロンプトを表示しないよう指定します。

/silent

ビルドの削除中に出力をコマンド プロンプト ウィンドウに書き出さないよう指定します。 /noprompt を意味します。

解説

適切なアクセス許可がない場合にビルドを破棄しようとすると、そのことを伝えるダイアログ ボックスが表示されます。

使用例

次の例では、2010 年 11 月 20 日より前であり、かつ "New Works" チーム プロジェクトの "Nightly Build" ビルド定義に基づくビルドを永続的に破棄します。

>tfsbuild.exe destroy /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"New Works\Nightly Build" /daterange:~2010-11-20

参照

その他の技術情報

Team Foundation ビルド コマンド

完了したビルドの削除

ビルドの実行と監視

ビルド処理の定義

基本的なビルド定義の作成