导入和导出类别 [witadmin]
可以使用以下 witadmin 命令导入和导出为团队项目定义的类别：
exportcategories：导出运行 Team Foundation Server 的服务器上定义的类别的 XML 定义。
importcategories：将工作项类型 XML 定义文件导入运行 Team Foundation Server 的服务器上的团队项目。
如果带相同名称的类别已存在，则此命令将覆盖现有定义。 如果工作项类型尚不存在，则此命令将创建一个新类别。
若要了解默认类别及其使用方式，请转到此处。
witadmin 命令行工具仅在对本地 TFS 运行时才有效。 若要运行此工具，请打开安装了 Visual Studio 或 团队资源管理器 的命令提示符窗口，然后输入：
cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE
在 32 位版本的 Windows 上，将 %programfiles(x86)% 替换为 %programfiles%。
备注
过程编辑器是 Visual Studio 的一个增强工具，可使用该工具创建或修改类别。此增强工具不受支持。有关详细信息，请参阅 Microsoft 网站上的以下页面：Team Foundation Server 增强工具。
要求
对于为其定义类别的团队项目，您必须具有以下权限集：
若要导出工作项类型的类别，必须将您的**“查看项目级别信息”权限设置为“允许”**。
若要导入工作项类型的类别，您必须是**“项目管理员”安全组的成员，或者已将“编辑项目级别信息”权限设置为“允许”**。
witadmin exportcategories /collection:CollectionURL /p:Project [/f:FileName] [/e:Encoding]
witadmin importcategories /collection:CollectionURL /p:Project /f:FileName [/e:Encoding]
参数
参数 |
描述 |
|---|---|
/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 文件结构的信息，请参阅类别 XML 元素引用。
示例
除非另外指定，否则在每个示例中应用下面的值：
团队项目集合的 URI：http://AdventureWorksServer:8080/tfs/DefaultCollection
项目名称：AdventureWorks
输入或输出文件的名称：myCategories.xml
默认编码：UTF-8
列出类别
下面的命令列出了为 AdventureWorks 项目定义的工作项类型类别。
witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks
将类别添加到隐藏的类型类别
将类别添加到隐藏的类型类别可移除对用户在该类别中创建工作项类型的支持。
导出您团队项目的类别定义文件。
witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml在首选文本编辑器中打开“类别”文件，并查找 CATEGORY 的 "Hidden Types Category" 元素。
<CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory"> <DEFAULTWORKITEMTYPE name="Code Review Request" /> <WORKITEMTYPE name="Code Review Response" /> <WORKITEMTYPE name="Feedback Request" /> <WORKITEMTYPE name="Feedback Response" /> <WORKITEMTYPE name="Shared Steps" /> </CATEGORY>添加指定要添加的工作项类型的友好名称的 WORKITEMTYPE 元素。
例如，以下语法可将自定义工作项类型“集成版本”添加到“隐藏的类型类别”。
<CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory"> <DEFAULTWORKITEMTYPE name="Code Review Request" /> <WORKITEMTYPE name="Code Review Response" /> <WORKITEMTYPE name="Feedback Request" /> <WORKITEMTYPE name="Feedback Response" /> <WORKITEMTYPE name="Shared Steps" /> <WORKITEMTYPE name="Integration Build" /> </CATEGORY>将类别的定义文件导入您的团队项目中。
witadmin importcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml