自定义和管理链接类型
可以使用以下 witadmin 命令管理为团队项目集合定义的链接类型：
deactivatelinktype：停用指定的链接类型。 用户将无法再创建此类型的链接。 此类型的现有链接将继续正常工作。
deletelinktype：从数据库中永久删除指定的链接类型。 也将删除使用此链接类型定义的所有链接。
exportlinktype：导出链接类型的定义。 您可以导出单个链接类型或为服务器定义的所有链接类型的定义。
importlinktype：从 XML 文件导入的链接类型的定义。 如果具有相同引用名称的链接类型已经存在，则将进行更新以匹配导入的链接类型。 如果不存在该链接类型，则将创建新连接类型。
listlinktypes：列出服务器上可用的链接类型集。
reactivatelinktype：将重新激活指定的链接类型，还可以为它分配一个新名称。
在运行 团队资源管理器 的客户端计算机上，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 网站：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 |
在“命令提示符”窗口中显示有关命令的帮助。 |
备注
有关链接类型定义架构的结构，请参见使用链接类型。
示例
除非另外指定，否则下面的值适用于每个示例：
团队项目集合的 URI：http://AdventureWorksServer:8080/AWTeam/Collection1
服务器名称: AdventureWorksServer
输入或输出文件的名称：myLinkTypes.xml
链接类型名称：mylinktype
默认编码：UTF-8
列出链接类型
下面的命令显示为 Team Foundation AdventureWorksServer 定义的自定义链接类型。
witadmin listlinktypes /collection:http://AdventureWorksServer:8080/AWTeam/Collection1
列出链接类型的定义
下面的示例在“命令提示符”窗口中显示链接类型的定义：
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1
停用，然后重新激活链接类型
下面的示例停用链接类型 mylinktype，然后将其重新激活：
witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype
导出链接类型的定义
下面的命令将所有链接类型的定义导出到文件 mylinktype.xml：
witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml
导入链接类型的定义
下面的示例导入 XML 文件中定义的链接类型的定义：
witadmin importlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml