witAdmin：管理用于跟踪工作项的对象

  • 项目

更新：2011 年 1 月

通过创建和自定义用于跟踪工作项的对象，可以更改跟踪团队进度的方式。 使用 witadmin 命令行工具，可以创建、删除、导入和导出对象，例如类别、全局列表、全局工作流、链接类型以及工作项类型。 还可以永久删除工作项类型，或者删除、列出或更改工作项中字段的特性。

如下图所示，可以管理每个团队项目的类别和工作项类型。 可以管理每个团队项目集合的全局列表、链接类型和工作项字段。 可以自定义团队项目或集合的全局工作流。

工作项跟踪对象

可以在运行 团队资源管理器 的任何客户端计算机上的“驱动器:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE”中找到 witadmin 命令行工具。 对于 64 位计算机，该工具位于驱动器:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE 中。

提示

进程编辑器是 Visual Studio 的一个增强工具，您可以使用该工具来创建或修改用于跟踪工作项的对象。 此工具不受支持。 有关更多信息，请参见 Microsoft 网站上的以下页面：Team Foundation Server 增强工具 2010 年 4 月版。

主题内容

  • 先决条件

  • 全局参数

  • 命令索引

先决条件

若要使用 witadmin 命令行工具，您必须连接到正在运行以下 Team Foundation Server 服务器和服务的网络：

  • Team Foundation Server 的应用层服务器

  • Microsoft SQL Server 2008

  • SQL Server Reporting Services

  • Active Directory 域控制器

  • Internet 信息服务 (IIS) 6.0 或 7.0

  • .NET Framework 

全局参数

可以使用以下参数来显示 witadmin 的帮助文本。

参数

说明

/help

或

/?

显示 witadmin 命令行工具的语法和参数。

command /help

或

command /?

显示指定的 witadmin 命令的语法和参数。

命令索引

任务

相关内容

创建和修改工作项类型。 工作项类型定义用于创建和管理工作项的字段和行为。 可以创建和修改工作项类型，以支持团队和团队项目的过程目标。

可以使用以下 witadmin 命令管理团队项目的工作项类型：

  • destroywitd：删除工作项类型。

  • exportwitd：导出工作项类型的 XML 定义。

  • importwitd：导入工作项类型的 XML 定义。

  • listwitd：列出工作项类型的名称。

  • renamewitd：更改工作项类型的显示名称。

定义和管理工作项类型组。 可以使用类别对工作项类型进行分组，然后作为一组对它们执行操作。 例如，可以在定义工作项查询条件时指定一个类别，无论工作项的类型是否相同，都能找出该类别中的所有工作项。

可以使用以下 witadmin 命令管理团队项目的工作项类别：

  • exportcategories：导出所有类别的 XML 定义。

  • importcategories：导入所有类别的 XML 定义。

创建、修改、导出、导入和显示工作项类型的全局列表。 使用全局列表，可以在多个工作项类型之间共享列表项。

可以使用以下 witadmin 命令来管理集合的全局列表：

  • destroygloballist：删除全局列表。

  • exportgloballist：导出包含一个或多个全局列表的 XML 定义文件。

  • importgloballist：导入定义一个或多个全局列表的 XML 文件。

  • listgloballist：列出为此集合定义的每个全局列表的名称。

创建、修改、导出或导入全局工作流。 使用全局工作流，可以将定义和更新由许多工作项和团队项目共享的工作项字段和全局列表所需的工作减到最少。 可以在多个工作项类型之间共享字段定义和列表项。

可以使用以下 witadmin 命令管理每个团队项目或集合的全局工作流：

  • exportglobalworkflow：导出定义全局工作流的 XML 文件。

  • importglobalworkflow：导入定义全局工作流的 XML 文件。

创建、修改、列出、激活、停用、导入和导出链接类型。 使用链接类型，可以基于一组链接规则来关联工作项。 创建自定义链接类型时，可以通过更多方式来跟踪工作项及其依赖项。

可以使用以下 witadmin 命令来管理集合的链接类型：

  • deactivatelinktype：停用指定的链接类型。

  • deletelinktype：从数据库永久移除指定类型的链接。

  • exportlinktype：导出一种或多种链接的 XML 定义文件。

  • importlinktype：导入一种或多种链接的 XML 定义文件。

  • listlinktypes：列出服务器上的链接类型集。

  • reactivatelinktype：重新激活指定的链接类型。 也可以对链接类型进行重命名。

删除、列出和重命名工作项类型中的字段，重新定义确定索引和报告特征的字段。 可以使用字段来查找工作项和跟踪工作项中的信息。

可以使用以下 witadmin 命令来管理集合的字段：

  • deletefield：删除指定的字段。

  • listfields：列出指定字段的特性或所有字段的特性。

  • indexfield：打开或关闭指定字段的索引。

  • changefield：更改指定字段的一个或多个特性。

销毁工作项。 可以使用 witadmin destroywi 命令从团队项目集合永久移除工作项。

强制重新生成客户端缓存。 在执行某些维护操作之后，可以强制所有客户端计算机在下次连接到团队项目集合时重新生成缓存。 例如，您可以在对数据层或应用层服务器进行移动、重命名、还原或故障转移之后强制重新生成。 通过强制重新生成，可防止在版本控制或生成操作期间发生工作区错误。 若要执行此操作，可以使用 witadmin rebuildcache 命令。

请参见

概念

自定义项目跟踪数据、窗体、工作流及其他对象

其他资源

确定过程并跟踪自定义要求

使用 Team Foundation Server 命令行工具

修订记录

日期

修订记录

原因

2011 年 1 月

添加了有关全局工作流的信息以及有关跟踪工作项的对象的图示。

信息补充。