通过

自定义和管理工作项类型

  • 项目

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

  • destroywitd：销毁工作项类型和销毁永不恢复的该类型的每个工作项。

  • exportwitd：将工作项类型的定义导出到 XML 文件或命令提示符窗口。

  • importwitd：将工作项类型从 XML 定义文件导入运行 Team Foundation Server 的服务器上的团队项目。如果具有相同名称的工作项类型已经存在，则该新工作项类型会覆盖现有工作项类型。如果工作项类型尚不存在，则此命令将创建一个工作项类型。若要验证定义工作项类型的 XML，但不导入文件，可以使用 /v 选项。

  • listwitd：在命令提示符窗口中显示指定项目中的工作项类型的名称。

  • renamewitd：更改特定项目中的工作项类型的显示名称。运行此命令后，该类型的所有工作项将显示新名称。

若要运行 witadmin 命令行工具，请打开已安装 Visual Studio 或 团队资源管理器 的“命令提示”窗口，然后输入：

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

在 64 位 Windows 版本上，将 %programfiles% 替换为 %programfiles(x86)%。

有关工作项类型的更多信息，请参见向过程模板添加工作项的类型定义。

说明说明

进程编辑器是 Visual Studio 的一个增强工具，您可以使用该工具创建和修改工作项类型。此工具不受支持。有关更多信息，请参见 Microsoft 网站上的以下页面：Team Foundation Server Power Tools（Team Foundation Server 增强工具）。

要求

对于定义工作项类型处的团队项目，您必须具有以下权限集：

  • 若要导出或列出工作项类型，您必须是**“Project Administrators (项目管理员)”组的成员，或者将“查看项目级别信息”权限设置为“允许”**。

  • 若要销毁、导入或重命名工作项类型，您必须是**“Team Foundation Administrators (Team Foundation 管理员)”安全组或“Project Administrators (项目管理员)”**安全组的成员。

有关更多信息，请参见Team Foundation Server 权限和Team Foundation Server 默认组、权限和角色。

说明说明

即使您是以管理权限登录的，也必须使用提升的权限打开命令提示符窗口，才能在运行 Windows Server 2008 的服务器上执行此功能。若要使用提升的权限打开命令提示符窗口，请选择“开始”，打开“命令提示符”的快捷菜单，然后选择“以管理员身份运行”。有关更多信息，请参见以下 Microsoft 网站：User Access Control（用户访问控制）。

 
witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]

witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]

witadmin importwitd /collection:CollectionURL [/p:Project] /f:FileName [/e:Encoding] [/v]

witadmin listwitd /collection:CollectionURL /p:Project

witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]

参数

Parameter

说明

/collection:CollectionURL

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

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

http://服务器名称:端口/集合名称

/p:Project

要为其管理工作项类型的团队项目。必须在 /collection 参数指定的项目集合中定义此团队项目。

除非运行 importwitd 命令和 /v 选项，否则 /p 参数是必需的。

/n:TypeName

要销毁、导出、导入或重命名的工作项类型的名称。

/f:FileName

包含要导出或导入的工作项类型的 XML 定义文件的路径和文件名称。如果省略此参数，则在使用 exportwitd 命令时，XML 将显示在命令提示符窗口中。

说明说明
如果您使用的是 Windows Vista，则可能无权访问某些文件夹。如果尝试将工作项类型导出到您没有权限的位置，注册表虚拟化技术将自动重定向导出的文件，并将其保存到虚拟存储区。若要避免此重定向操作，可以将该文件导出到您拥有权限的位置。有关注册表虚拟化的更多信息，请参见 Microsoft 网站：Registry Virtualization（注册表虚拟化）和 Windows Vista 中常见的文件和注册表虚拟化问题。

/e:编码

.NET Framework 2.0 编码格式的名称。该命令使用指定的编码导出或导入 XML 数据。例如，/e:utf-7 指定 Unicode (UTF-7) 编码。如果省略此参数，则 witadmin 将尝试检测编码，并且如果检测失败，则 witadmin 将使用 UTF-8。

/exportgloballists

导出工作项类型引用的全局列表的定义。全局列表的定义将嵌入到工作项类型定义 XML。如果未指定，则忽略全局列表的定义。

/v

验证定义工作项类型的 XML，但不导入 XML 定义文件。

说明说明
可以验证类型定义，而不指定团队项目。忽略对项目范围组的引用。

/new:NewName

工作项类型的新名称。

/noprompt

禁用提示进行确认。

/? 或 help

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

备注

使用 destroywitd 命令时，它销毁所有以下对象：

  • 工作项类型

  • 该类型的所有工作项

  • 工作项表、长文本表和链接表中的对应项

  • 工作项类型元数据缓存中的对象

示例

除非另外指定，否则下面的值适用于每个示例：

  • 团队项目集合的 URI：http://AdventureWorksServer:8080/tfs/DefaultCollection

  • 项目名称：AdventureWorks

  • 输入或输出文件的名称：myworkitems.xml

  • 工作项类型名称：myworkitem

  • 默认编码：UTF-8

Dd312129.collapse_all(zh-cn,VS.110).gif导出工作项类型的定义

下面的命令将 myworkitem 的定义导出到文件 myworkitems.xml。

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem

下面的示例用 Unicode (UTF-7) 编码导出工作项。

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

Dd312129.collapse_all(zh-cn,VS.110).gif导出工作项类型和其引用的全局列表的定义

下面的示例导出工作项类型和其引用的全局列表。

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists

Dd312129.collapse_all(zh-cn,VS.110).gif列出工作项类型的定义。

下面的示例在“命令提示符”窗口中显示工作项类型的定义。

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem

Dd312129.collapse_all(zh-cn,VS.110).gif导入工作项类型的定义

下面的示例从 XML 文件导入工作项定义。

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks

Dd312129.collapse_all(zh-cn,VS.110).gif验证工作项类型的 XML 定义

下面的示例验证定义工作项类型但是不会导入定义的 XML。

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

请参见

任务

创建工作项类型

概念

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

其他资源

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