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

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

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

工作项跟踪对象

备注

进程编辑器是 Visual Studio 的一个增强工具,你可以使用该工具创建和修改用于跟踪工作项的对象。此工具不受支持。有关详细信息,请参阅 Microsoft 网站上的以下页面:Team Foundation Server 增强工具

全局参数

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

参数

描述

/help

/?

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

command /help

command /?

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

命令索引

若要访问 witadmin 命令行工具,请在安装了 Visual Studio 或团队资源管理器的情况下打开命令提示符窗口,然后输入:

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

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

任务

相关内容

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

通过使用以下 witadmin 命令,可管理团队项目的工作项类型:

  • destroywitd:删除工作项类型。

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

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

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

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

自定义过程配置。 你可以自定义团队 Web 访问的 Agile 体验。

  • exportprocessconfig:导出过程配置的 XML 定义。

  • importprocessconfig:导入过程配置的 XML 定义。

导入和导出类别。 通过使用类别,可对工作项类型进行分组,然后在作为集合的组上执行操作。 例如,你可以在定义工作项查询的条件时指定类别,以在该类别中查找所有工作项,而不考虑这些项的类型是否不同。

通过使用以下 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 命令。

请参见

概念

配置和自定义团队项目的敏捷计划工具

自定义工作跟踪对象以支持团队的进程

其他资源

TFS 的命令行工具