将团队项目集合映射到 PWA 实例
在 Visual Studio Team Foundation Server 2010 和 Microsoft Project Server 2007（含 Service Pack 2 (SP2)）或 Project Server 2010 之间同步数据以前，必须先执行若干个任务，包括将团队项目集合映射到 Project Web Access 或 Project Web App (PWA) 的实例。 可以使用 TFSAdmin 命令行工具中的以下选项来管理此映射：
/MapPWAToCollection：将团队项目集合映射到 PWA 的实例。 可以将多个集合映射到一个实例，也可以将每个集合仅映射到一个实例。 在将集合映射到实例之前，必须先注册该实例。
/GetMappedCollections：返回已映射到 PWA 的实例的团队项目集合列表。
/UnmapPWAFromCollection：从 PWA 的实例中移除团队项目集合的映射。
有关如何集成这些产品的端对端概述，请参见配置 Team Foundation Server 与 Project Server 的集成。
要使用 TFSAdmin 命令行工具，您需要在运行 团队资源管理器 和 Visual Studio 2010 Service Pack 1 的计算机上打开命令提示符窗口。可以从以下目录中运行此工具：驱动器:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE。 对于 64 位计算机，该工具位于驱动器:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE 中。
所需权限
若要使用这些命令，团队项目集合的**“管理 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/Collection0
列出已映射的项目集合
下面的示例列出在 AdventureWorksServer 上定义且映射到 PWA 实例的团队项目集合。
TfsAdmin ProjectServer /GetMappedCollections /tfs:http://AdventureWorksServer:8080/tfs/
将团队项目集合映射到 PWA 实例
下面的示例将 Collection0 映射到在 AdventureWorksServer 上定义的 PWAInstance。
TfsAdmin ProjectServer /MapPWAToCollection /pwa:http://PWAServerName/PWAInstance /collection:http://AdventureWorksServer:8080/tfs/Collection0
移除集合的映射
下面的示例从 PWAInstance 中移除 Collection0 的映射。
TfsAdmin ProjectServer /UnmapPWAFromCollection /pwa:http://PWAServerName/PWAInstance /collection:http://AdventureWorksServer:8080/tfs/Collection0
返回页首