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 |
此生成定义所属的团队项目的名称。 |
definitionSpec |
与 /builddefinition 一起使用。 要删除的生成。 支持通配符。 |
buildNumber |
一个空格分隔列表,其中包含要删除的生成。 如果内部版本号中有空格,请将该版本号括在单引号中。 支持通配符。 |
buildUri |
一个空格分隔列表,其中包含要删除的生成的 URI。 |
teamProjectCollectionUrl |
您要删除的生成所在的团队项目集合的 URL(例如,http://myserver:8080/tfs/DefaultCollection)。 |
deleteOptions |
用户为 /deleteOptions 选项提供的值。 要删除生成,您可以指定以下一个或多个选项:
|
date |
用户提供的 /daterange 选项的值。 可以使用“~”来指定日期范围,如下面的示例所示:
|
选项 |
说明 |
---|---|
/noprompt |
删除生成时不给予提示。 |
/silent |
删除时不将输出写到命令提示符窗口。 暗含 /noprompt。 |
/builddefinition |
指定要删除的生成定义或定义。 |
/collection |
指定团队项目集合。 |
/deleteOptions |
指定用于删除生成的选项。 |
/preview |
显示将发生的情况,而不实际执行 delete 操作。 |
/daterange |
指定要删除的生成的日期范围。 |
备注
删除过程
如果在此过程中失败,将显示警告消息。 但是,即使出现警告,删除操作仍被视为成功。
删除多个生成
如果指定多个生成,则删除其中一个生成失败不会导致整个过程停止。 该命令在提供生成删除失败错误消息之后会继续删除其他生成。
事件日志
有关删除生成的信息会记录在事件日志中。 日志中将包含有关删除生成的人员、删除生成的时间以及内部版本号的信息。
示例
下面的示例从 http://myserver:8080/tfs/DefaultCollection 上的团队项目集合的 AdventureWorks 团队项目中删除按生成编号定义的两个生成“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 上的团队项目集合的 AdventureWorks 团队项目中删除 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 上的团队项目集合的 AdventureWorks 团队项目中删除按生成 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