Destroy 命令 (Team Foundation Build)
可以使用 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 日且以“新工作”团队项目中的“每夜生成”生成定义为基础的生成。
>tfsbuild.exe destroy /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"New Works\Nightly Build" /daterange:~2010-11-20