永久移除工作项 [witadmin]

通过使用 Team Foundation 命令,可从团队项目集合的 witadmin destroywi 数据库中永久删除一个或多个工作项。 状态设置为“已关闭”的工作项将保留在数据库中,并且可以将其重新激活。 永久删除的工作项是从数据库删除的,无法还原,也无法重新激活。

每个工作项表示存储在 Team Foundation 数据库以及分配有唯一标识符(称为工作项 ID)的对象。 工作项 ID 在项目集合内是唯一的。

witadmin 命令行工具仅在对本地 TFS 运行时才有效。 若要运行此工具,请打开安装了 Visual Studio 或 团队资源管理器 的命令提示符窗口,然后输入:

cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE

在 32 位版本的 Windows 上,将 %programfiles(x86)% 替换为 %programfiles%

要求

  • 你必须是“Team Foundation Administrators”安全组的成员或者是团队项目集合的“项目管理员”安全组的成员。 请参阅 Team Foundation Server 权限参考

备注

即使你以管理权限登录,也必须打开提升的命令提示符窗口,以在运行 Windows Server 2008 的服务器上执行此功能。若要打开提升的命令提示符窗口,请选择“开始”,打开“命令提示符”的快捷菜单,然后选择“以管理员身份运行”。有关详细信息,请参阅 Microsoft 网站

witadmin destroywi /collection:CollectionURL /id:id [/noprompt]

参数

参数

描述

/collection:CollectionURL

指定团队项目集合的 URI。 URI 的格式如下:http://ServerName:Port/VirtualDirectoryName/CollectionName

如果未使用虚拟目录,则 URI 将为以下格式:

http://ServerName:Port/CollectionName。

/id:id

要销毁的工作项 ID。 要指定多个工作项,请仅使用逗号,而非空格分隔 ID。

/noprompt

禁用请求确认的提示。

/?help

在“命令提示符”窗口中显示有关命令的帮助。

示例

从数据库中永久移除工作项

以下示例从 AdventureWorksServer 服务器上 Collection1 的数据库删除工作项 2003:

witadmin destroywi /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /id:2003

以下示例从 AdventureWorksServer 服务器上 Collection1 的数据库删除 ID 为 12、15 和 23 的工作项:

witadmin destroywi /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /id:12,15,23

请参见

概念

使用工作项管理项目

其他资源

witAdmin:自定义和管理用于跟踪工作的对象