将团队项目集合映射到 PWA 实例

项目
02/21/2013

在可以同步。Visual Studio Team Foundation Server 2012 与 Microsoft Project Server 之间之前，必须执行包括将团队项目集合映射到 project Web Access 或 project Web App (PWA) 实例的任务。可以使用 TFSAdmin 命令行工具中的以下选项来管理此映射：

/MapPWAToCollection：将团队项目集合映射到 PWA 的实例。可以将多个集合映射到一个实例，也可以将每个集合仅映射到一个实例。在将集合映射到实例之前，必须先注册该实例。
/GetMappedCollections：返回已映射到 PWA 的实例的团队项目集合列表。
/UnmapPWAFromCollection：从 PWA 的实例中移除团队项目集合的映射。

有关如何集成这些产品的端对端概述，请参见配置 Team Foundation Server 与 Project Server 的集成。

若要使用 TFSAdmin 命令行工具，请打开 Visual Studio 或团队资源管理器安装的命令提示符窗口并 enter:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

在 64 位 Windows 版本上，将 %programfiles% 替换为 %programfiles(x86)%。

必需的权限

若要使用这些命令，团队项目集合的**“管理 Project Server 集成”权限必须设置为“允许”**。此外，必须还要向 Team Foundation Server 的服务帐户授予与参与数据同步的 PWA 实例进行交互所需的权限。有关更多信息，请参见分配权限以支持 Project Server 和 Team Foundation Server 集成。

备注

即使您是以管理权限登录的，也必须使用提升的权限打开命令提示符窗口，才能在运行 Windows Server 2008 的服务器上执行此功能。若要使用提升的权限打开命令提示符窗口，请选择“开始”，打开“命令提示符”的快捷菜单，然后选择“以管理员身份运行”。有关更多信息，请参见 Microsoft 网站上的以下页面：用户帐户控制。

语法

TfsAdmin ProjectServer /GetMappedCollections /tfs:tfsUrl 

TfsAdmin ProjectServer /MapPWAToCollection /pwa:pwaUrl /collection:tpcUrl

TfsAdmin ProjectServer /UnmapPWAFromCollection /pwa:pwaUrl /collection:tpcUrl [/force]

参数

Parameter	描述
/tfs:tfsUrl	指定 Team Foundation 应用层服务器的统一资源的定位器 (URL)。可以按以下格式指定 URL： http://服务器名称:端口/虚拟目录名称如果不指定虚拟目录，则必须按以下格式指定 URI： http://服务器名称:端口
/pwa:pwaUrl	指定 PWA 实例的 URL。可以按以下格式指定 URL： http://PWA 服务器名称/PWA
/collection:tpcUrl	指定团队项目集合的 URL。可以按以下格式指定 URL： http://服务器名称:端口/虚拟目录名称/集合名称如果不指定虚拟目录，则必须按以下格式指定 URI： http://服务器名称:端口/集合名称
/force	可选。仅可用于 /UnmapPWAFromCollection 选项。移除集合中所有团队项目的所有映射。只有在您确信您不再希望集合中的任何团队项目继续参与数据同步时，才应指定此选项。
/? 或 help	显示有关此命令的信息。

返回页首

备注

当您运行命令时，会显示一条消息，确认正在执行的操作和操作的对象。例如，下面的消息说明正在映射指定的 PWA 实例：

Mapping Project Web Access:http://MyPWAServer/MyPWAInstance/ . . . Done.

完成此命令后，会出现另一条消息。例如，下面的消息表示已经在 Team Foundation Server 中注册了 PWA 的实例：

Mapping team project collection http://MyTFSServer:8080/tfs/Collection0 to PWA http://MyPWAServer/MyPWAInstance/.

当您映射团队项目集合时，将会执行以下操作：

该集合的位置服务进行了更新以反映映射。
创建了集合上的全局规则和字段。
同步引擎向作业服务进行注册。

在从 PWA 的实例集合取消映射以前，必须先取消映射所有针对团队项目集合的映射的团队项目和企业项目计划。如果运行 /UnmapPWAFromCollection 选项时映射了项目，将会显示一条消息，通知您您必须首先使用 /UnmapPlanFromProject 选项。或者，也可以使用 /force 标志来移除集合中所有团队项目的所有映射。

可以通过运行 /GetMappedProjects 选项来显示映射项目的列表。有关更多信息，请参见管理企业项目与团队项目之间的映射。

如果无项目映射到的集合上运行 /UnmapPWAFromCollection，该命令将不仅移除映射，而且移除全局规则。

返回页首

示例

以下值适用于每个示例：

PWA 实例的 URL：http:// PWAServerName/PWAInstance/
Team Foundation Server 的 URL：http://AdventureWorksServer:8080/tfs/
团队项目集合的 URL:http://AdventureWorksServer:8080/tfs/DefulatCollection

列出已映射的项目集合

下面的示例列出在 AdventureWorksServer 上定义且映射到 PWA 实例的团队项目集合。

TfsAdmin ProjectServer /GetMappedCollections /tfs:http://AdventureWorksServer:8080/tfs/