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 が解析できる任意の形式の日付。 日付範囲を指定するには、次の例に示すとおり、"~" を使用します。
|
オプション |
説明 |
|---|---|
/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