通过

自定义和管理链接类型 [witadmin]

  • 项目

类似于工作项类型，可以定义和修改自定义链接类型。 但是，您不能对系统定义的链接类型进行任何更改。 在添加新链接类型到团队项目集合之前，请查看链接类型是否可用。 请参见 链接工作项和对象以支持可跟踪性。

可使用以下 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

Dd273716.collapse_all(zh-cn,VS.110).gif列出链接类型

下面的命令显示为 Team Foundation AdventureWorksServer 定义的自定义链接类型。

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Dd273716.collapse_all(zh-cn,VS.110).gif列出链接类型的定义

下面的示例在“命令提示符”窗口中显示链接类型的定义：

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Dd273716.collapse_all(zh-cn,VS.110).gif停用，然后重新激活链接类型

下面的示例停用链接类型 mylinktype，然后将其重新激活：

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:mylinktype

Dd273716.collapse_all(zh-cn,VS.110).gif导出链接类型的定义

下面的命令将所有链接类型的定义导出到文件 mylinktype.xml：

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

Dd273716.collapse_all(zh-cn,VS.110).gif导入链接类型的定义

下面的示例导入 XML 文件中定义的链接类型的定义：

witadmin importlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml

请参见

概念

链接类型元素参考

链接工作项以及链接控件和限制

其他资源

链接工作项和对象以支持可跟踪性

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