自定义和管理链接类型
类似于工作项类型,可以定义和修改自定义链接类型。但是,您不能对系统定义的链接类型进行任何更改。在添加新链接类型到团队项目集合之前,请查看链接类型是否可用。请参见 链接工作项和对象以支持可跟踪性。
可使用以下 witadmin 命令管理为团队项目集合定义的链接类型:
deactivatelinktype:停用指定的链接类型。用户将无法再创建此类型的链接。此类型的现有链接将继续正常工作。
deletelinktype:从数据库中永久删除指定的链接类型。也将删除使用此链接类型定义的所有链接。
exportlinktype:导出链接类型的定义。您可以导出单个链接类型或为服务器定义的所有链接类型的定义。
importlinktype:从 XML 文件导入链接类型的定义。如果已存在一个具有相同引用名称的链接类型,则将更新该链接类型以便与导入的链接类型匹配。如果链接类型尚不存在,则将新建一个链接类型。
listlinktypes:列出服务器上可用的链接类型集。
reactivatelinktype:将重新激活指定的链接类型,还可以为它分配一个新名称。
若要运行 witadmin 命令行工具,请打开已安装 Visual Studio 或 团队资源管理器 的“命令提示”窗口,然后输入:
cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE
在 64 位 Windows 版本上,将 %programfiles% 替换为 %programfiles(x86)%。
要求
对于定义链接类型处的团队项目集合,您必须具有以下权限集:
若要列出或导出链接类型,则您必须将您集合中一个团队项目的**“查看项目级别信息”权限设置为“允许”**。
若要删除、导入或重新激活链接类型,您必须是**“项目集合管理员”安全组的成员或将您的“管理工作项链接类型”权限设置为“允许”**。
有关更多信息,请参见Team Foundation Server 权限和Team Foundation Server 默认组、权限和角色。
![]() |
---|
即使您是以管理权限登录的,也必须使用提升的权限打开命令提示符窗口,才能在运行 Windows Server 2008 的服务器上执行此功能。若要使用提升的权限打开命令提示符窗口,请选择“开始”,打开“命令提示符”快捷菜单,然后选择“以管理员身份运行”。有关更多信息,请参见以下 Microsoft 网站:User Access Control(用户访问控制)。 |
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
参数
Parameter |
描述 |
---|---|
/collection:CollectionURL |
指定团队项目集合的 URI。URI 的格式为:http://ServerName:Port/VirtualDirectoryName/CollectionName 例如: http://ServerName:8080/tfs/Collection0 如果未使用虚拟目录,则 URI 将为以下格式: http://服务器名称:端口/集合名称 |
/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