自定义工作项类型的类别
可以使用以下 witadmin 命令管理为团队项目定义的工作项类型的类别：
exportcategories：导出运行 Team Foundation Server 的服务器上定义的类别的 XML 定义。
importcategories：将工作项类型 XML 定义文件导入运行 Team Foundation Server 的服务器上的团队项目。
如果具有相同名称的某个类别已经存在，则此命令会覆盖现有的定义。 如果工作项类型尚不存在，则此命令将创建一个新类别。
在运行 团队资源管理器 的客户端计算机上，witadmin 命令行实用工具位于驱动器:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE 中。
提示
进程编辑器是 Visual Studio 的一个增强工具，您可以使用该工具来创建或修改类别。 此增强工具不受支持。 有关更多信息，请参见 Microsoft 网站上的以下页面：Team Foundation Server Power Tools April 2010（Team Foundation Server 增强工具 2010 年 4 月版）。
所需权限
对于定义工作项类型处的团队项目，您必须具有以下权限集：
若要导出工作项类型的类别，您必须是**“Readers (访问者)”组的成员，或者将“查看此节点中的工作项”权限设置为“允许”**。
若要导入工作项类型的类别，您必须是**“Team Foundation Administrators (Team Foundation 管理员)”安全组或“Project Administrators (项目管理员)”**安全组的成员。
有关更多信息，请参见Team Foundation Server 权限和Team Foundation Server 默认组、权限和角色。
提示
即使您是以管理权限登录的，也必须使用提升的权限打开命令提示符窗口，才能在运行 Windows Server 2008 的服务器上执行此功能。 若要使用提升的权限打开命令提示符窗口，请单击“开始”，右击“命令提示符”，然后单击“以管理员身份运行”。 有关更多信息，请参见以下 Microsoft 网站：用户帐户控制。
witadmin exportcategories /collection:CollectionURL /p:Project [/f:FileName] [/e:Encoding]
witadmin importcategories /collection:CollectionURL /p:Project /f:FileName [/e:Encoding]
参数
Parameter |
说明 |
|---|---|
/collection:CollectionURL |
指定团队项目集合的 URI。 URI 的格式为：http://ServerName:Port/VirtualDirectoryName/CollectionName 如果未使用虚拟目录，则 URI 将为以下格式： http://ServerName:Port/CollectionName。 |
/p:Project |
类别从其导出或类别导入至的团队项目的名称。 |
/f:FileName |
包含要导出或导入的类别的 XML 定义文件的路径和文件名称。 如果省略此参数，则在使用 exportcategories 命令时，该命令将列出命令提示符窗口中的类别。 |
/e:Encoding |
.NET Framework 2.0 编码格式的名称。 指定的编码将用于导出或导入 XML 数据。 例如，/e:utf-7 指定 Unicode (UTF-7) 编码。 如果省略此参数，则 witadmin 将尝试检测编码，并且如果检测失败，则 witadmin 将使用 UTF-8。 |
/? 或 help |
在“命令提示符”窗口中显示有关命令的帮助。 |
备注
如果这些类别尚不存在，则导入类别文件时会创建这些类别。 如果类别已经存在，witadmin importcategories 命令将警告您当前列表将被覆盖。 您可以编写自己的程序来更新现有类别集或使用新数据更新类别。
有关类别 XML 文件结构的信息，请参见类别定义架构参考。
示例
除非另外指定，否则下面的值适用于每个示例：
团队项目集合的 URI：http://AdventureWorksServer:8080/AWTeam/Collection1
项目名称：AdventureWorks
输入或输出文件的名称：myCategories.xml
默认编码：UTF-8
列出工作项类型类别
下面的命令列出了为 AdventureWorks 项目定义的工作项类型类别。
witadmin exportcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks
导出工作项类型类别
下面的命令将为 AdventureWorks 项目定义的工作项类型类别导出到 myCategories XML 文件。
witadmin exportcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myCategories.xml
导入工作项类型类别
下面的示例将类别从 myCategories XML 文件导入到 AdventureWorks 项目。
witadmin importcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myCategories.xml