管理链接类型 [witadmin]
类似于工作项类型，你可以定义和修改自定义链接类型。 但是，你无法修改任何系统定义的链接类型。 在添加新的链接类型到团队项目集合前，请检查可供你使用的链接类型。 请参阅链接工作项以支持可跟踪性。
通过使用以下 witadmin 命令，可管理为团队项目集合定义的链接类型：
deactivatelinktype：停用指定的链接类型。 用户将无法再创建此类型的链接。 此类型的现有链接将继续正确作用。
deletelinktype：从该数据库中永久删除指定的链接类型。 使用此链接类型定义的所有链接也已删除。
exportlinktype：导出链接类型的定义。 可以导出单个链接类型的定义或者为服务器定义的所有链接类型。
importlinktype：从 XML 文件导入链接类型定义。 如果存在具有相同引用名称的链接类型，该类型将更新以匹配导入的链接类型。 如果链接类型已不存在，将创建新的链接类型。
listlinktypes：在服务器上列出可用的链接类型集。
reactivatelinktype：重新激活指定的链接类型并有选择地对其分配新名称。
若要运行 witadmin 命令行工具，请在安装了 Visual Studio 或团队资源管理器的情况下打开命令提示符窗口，然后输入：
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
在 32 位版本的 Windows 上，将 %programfiles(x86)% 替换为 %programfiles%。
要求
对于在其中定义链接类型的团队项目，你必须具有以下权限集：
要列出或导出链接类型，你必须将集合中团队项目的“查看项目级信息”权限设置为“允许”。
若要删除、导入或重新激活链接类型，你必须是“项目集合管理员”安全组的成员，或者将“管理工作项链接类型”权限设置为“允许”。
有关详细信息，请参阅Team Foundation Server 权限参考。
备注
即使你以管理权限登录，也必须打开提升的命令提示符窗口，以在运行 Windows Server 2008 的服务器上执行此功能。若要打开提升的命令提示符窗口，请选择“开始”，打开“命令提示符”快捷菜单，然后选择“以管理员身份运行”。有关详细信息，请参见 Microsoft 网站：用户访问控制。
witadmin deactivatelinktype /collection:CollectionURL /n:LinkName
witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]
witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding]
witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]
witadmin listlinktypes /collection:CollectionURL
witadmin reactivatelinktype /collection:CollectionURL /n:LinkName
参数
参数 |
描述 |
|---|---|
/collection:CollectionURL |
指定团队项目集合的 URI。 URI 的格式如下：http://ServerName:Port/VirtualDirectoryName/CollectionName 例如： http://ServerName:8080/tfs/Collection0 如果未使用虚拟目录，则 URI 将为以下格式： http://ServerName:Port/CollectionName |
/n:LinkName |
要停用或删除的链接类型的名称或引用名称。 |
/f:FileName |
链接类型的 XML 文件。 对于导入是必须的，对于导出是可选的。 如果省略该参数，命令输出会在显示屏上出现。 |
/e:encoding |
.NET Framework 2.0 编码格式的名称。 指定的编码将用于导出或导入 XML 数据。 例如，/e:utf-7 指定 Unicode (UTF-7) 编码。 如果省略此参数，则 witadmin 将尝试检测编码，并且如果检测失败，witadmin 将使用 UTF-8。 |
/v |
验证链接类型 XML 而无需导入。 |
/noprompt |
禁用请求确认的提示。 |
/? 或help |
在“命令提示符”窗口中显示有关命令的帮助。 |
备注
有关链接类型定义架构的结构，请参阅 链接类型元素引用。
有关如何限制团队成员可以产生的链接类型关系，请参阅 链接控件、限制和字段引用 和 LinksControlOptions 元素。
示例
除非另外指定，否则在每个示例中应用下面的值：
团队项目集合的 URI：http://AdventureWorksServer:8080/tfs/DefaultCollection
服务器名称：AdventureWorksServer
输入或输出文件的名称：myLinkTypes.xml
链接类型名称：mylinktype
默认编码：UTF-8
列出链接类型
以下命令展示了为 Team Foundation AdventureWorksServer 定义的自定义链接类型。
witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
列出链接类型的定义
以下示例将在“命令提示符”窗口中显示链接类型的定义：
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
停用，然后重新激活链接类型
以下示例停用链接类型 mylinktype，然后再将其重新激活：
witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
导出链接类型的定义
以下命令会将所有链接类型的定义导出到文件 mylinktype.xml：
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml
导入链接类型的定义
以下示例会导入在 XML 文件中定义的链接类型的定义：
witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml