更新：2007 年 11 月
delete 命令删除指定的已完成生成。与生成有关的所有数据都将从生成代理和版本控制中删除，并清空放置位置。此外，生成资源管理器中将不再列出该生成。
必需的权限
若要运行 delete 命令，必须将请求删除操作的帐户的“管理生成”权限设置为“允许”。如果所删除的生成具有与之关联的测试结果，则该帐户的“发布测试结果”权限必须设置为“允许”。另外，应用层服务帐户和 Team Foundation Build 服务帐户对生成放置位置必需具有读/写权限。有关更多信息，请参见 Team Foundation Server 权限。
.gif "说明") 说明： |
|---|
即使您是使用管理凭据登录的，也必须使用提升的权限打开命令提示窗口，才能在正在运行 Windows Server 2008 的服务器上执行此功能。若要使用提升的权限打开命令提示窗口，请单击“开始”，右击“命令提示符”，然后单击“以管理员身份运行”。有关更多信息，请参见 Microsoft 网站。 |
TFSBuild delete [/noprompt] [/silent] /server:teamFoundationServer /builddefinition:definitionSpec buildNumbers…
TFSBuild delete [/noprompt] [/silent] /server:teamFoundationServer buildUris…
TFSBuild delete [/noprompt] [/silent] teamFoundationServer teamProject buildNumbers…
参数
参数 |
说明 |
|---|---|
teamfoundationserver |
用于生成的 Team Foundation 服务器 URL。 |
teamProject |
此生成定义所属的团队项目的名称。 |
definitionSpec |
与 /builddefinition 一起使用。要删除的生成。不支持通配符。 |
BuildNumbers |
一个空格分隔列表，其中包含要删除的生成。如果内部版本号中有空格，请将该版本号括在单引号中。不支持通配符。 |
buildUris |
一个空格分隔列表，其中包含要删除的生成的生成 URI。 例如 tfsbuild delete uri1 uri2 uri3 /s:MyServer。 |
选项 |
说明 |
|---|---|
/noprompt |
可选。删除生成时不给予提示。 |
/silent |
可选。删除时不将输出写到命令提示符窗口。暗含 /noprompt。 |
/server |
用于要删除的生成的 Team Foundation 服务器。 |
/builddefinition |
指定要删除的生成定义。 |
备注
删除过程
删除内部版本号时，请按照以下步骤进行：
验证内部版本号是有效的，并且生成尚未进行。
如果请求者有“管理生成”权限，则删除生成存储区和放置站点的内容。
从放置位置中清除此生成的二进制文件。如果在此过程中失败，将显示警告消息进行提示。但是，即使出现警告，删除操作仍被视为成功。
说明：不会从数据仓库中删除任何数据。
删除多个生成
如果指定多个生成，则删除其中一个生成失败不会导致整个过程停止。该命令在提供生成删除失败错误消息之后会继续删除其他生成。
事件日志
有关删除生成的信息会记录在事件日志中。日志中将包含有关删除生成的人员、删除生成的时间以及内部版本号的信息。
示例
下面的示例从 server01 上的 AdventureWorks 团队项目中删除由内部版本号“TestBuild1 1_20070510.1”和“TestBuild 1_20070510.2”定义的两个生成。
> > tfsbuild.exe delete http://server01:8080 Adventureworks “TestBuild1 1_20070510.1” “TestBuild 1_20070510.2”
下面的示例从 server01 上的 AdventureWorks 团队项目中删除其 definitionSpec 为“\Adventureworks\Definition1”的两个特定生成。
>tfsbuild.exe delete /server:http://server01:8080 /builddefinition:”\Adventureworks\Definition 1” “Definition 1_20070510.1” “Definition 1_20070510.2”
下面的示例从 server01 上的 AdventureWorks 团队项目中删除由生成 URI“vstfs:///TestBuild/TestBuild/1”和“vstfs:///TestBuild/TestBuild/2”定义的两个生成。
>tfsbuild.exe delete /server:http://server01:8080 vstfs:///TestBuild/TestBuild/1 vstfs:///TestBuild/TestBuild/29