向 Team Foundation Server 注册 PWA 实例

在 Visual Studio Team Foundation Server 2010 和 Microsoft Project Server 2007 或 Project Server 2010 之间同步数据以前,必须先在它们之间配置若干个集成点。 首先,您必须注册 Project Web Access 或 Project Web App (PWA) 的实例,用以通过承载团队项目集合(其中包含团队项目)的应用层服务器来支持企业项目计划。 可以使用 TFSAdmin ProjectServer 命令行工具中的以下命令来管理这些 PWA 实例的注册。

  • /RegisterPWA:向 Team Foundation Server 注册 PWA 的实例。

  • /GetRegisteredPWA:列出 PWA 的已注册实例和正在运行注册了这些实例的 Team Foundation Server 服务器的名称。

  • /UnregisterPWA:移除 PWA 的实例和 Team Foundation Server 之间的已注册关联。 当您移动团队项目集合或 Team Foundation Server 部署时,可以移除 PWA 的已注册实例,然后在移动后重新注册它们。

有关 Project Server 和 Team Foundation Server 的配置和集成的更多信息,请参见配置 Team Foundation Server 与 Project Server 的集成

要使用 TFSAdmin 命令行工具,您需要在运行 团队资源管理器 和 Visual Studio Team Foundation Server 2010 Service Pack 1 的计算机上打开命令提示符窗口。可以从以下目录中运行此工具:驱动器:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE。 对于 64 位计算机,该工具位于驱动器:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE 中。

所需权限

若要使用这些命令,您必须属于**“Team Foundation 管理员”**组。 若要注册或注销 PWA 实例,您还必须是该实例的 Administrators 组的成员。 有关更多信息,请参见分配权限以支持 Project Server 和 Team Foundation Server 集成

提示

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

语法

TfsAdmin ProjectServer /GetRegisteredPWA /tfs:tfsUrl

TfsAdmin ProjectServer /RegisterPWA /pwa:pwaUrl /tfs:tfsUrl [/previousPwa:pwaUrl] [/force]

TfsAdmin ProjectServer /UnregisterPWA /pwa:pwaUrl /tfs:tfsUrl

参数

Parameter

说明

/tfs:tfsUrl

指定 Team Foundation 应用层服务器的统一资源的定位器 (URL)。 可以按以下格式指定 URI:

http://服务器名称:端口/虚拟目录名称

如果不指定虚拟目录,则指定以下格式的 URL:

http://服务器名称:端口

/pwa:pwaUrl

指定 PWA 实例的 URL。 可以按以下格式指定 URL:

http://PWA 服务器名称/PWA 实例

/previousPwa:pwaUrl

指定为 PWA 实例最新注册的 URL。 所注册的 PWA 的 URL 更改时,您可以使用此开关来重新注册 PWA。 可以按以下格式指定 URL:

http://PWA 服务器名称/PWA 实例

/force

将 PWA 实例注册到另一个运行 Team Foundation Server 的服务器上,并从其最新注册的服务器上取消注册该实例。 例如,在将项目集合移动到另一个应用层服务器时,必须在新服务器上重新注册该集合的 PWA。

/?help

显示有关此命令的信息。

返回页首

备注

当您运行 TFSAdmin ProjectServer 命令时,会显示一条消息,确认该命令正在运行。 例如,下面的消息说明正在注册 Project Web Access 的实例:

Registering PWA http:// PWAServerName/PWAInstance/ 

完成此命令后,会出现另一条消息。 例如,下面的消息说明已经在 Team Foundation Server 中注册了 Project Web Access 的实例:

You have successfully registered PWA http://PWAServerName/PWAInstance/

一个 PWA 实例只能注册到一个 Team Foundation 应用层服务器中。 必须先注册实例,然后才可以将其与团队项目集合关联。 注册实例时,将使用该信息对 Team Foundation Server 的位置服务进行更新。 此外,还将使用集成需要的自定义字段和查找表来更新 PWA 的实例。

当您运行注册命令时,将发生以下操作:

  • 如果多次运行 /RegisterPWA,并且已存在注册的记录,将会显示以下消息:

    The following PWA instance has already been registered: <PWAInstance>.

  • 您在运行 /GetRegisteredPWA 时,将显示以下信息:

    The following PWA instances are registered:  
    PWA URL 1
    PWA URL 2
    
  • 当您运行 /UnRegisterPWA 选项时,该命令将不仅移除映射的关联,而且移除 PWA 实例中的自定义字段和查找表。

返回页首

示例

以下值适用于每个示例:

  • PWA 实例的 URL:http://PWAServerName/PWAInstance/

  • Team Foundation Server 的 URL:http://AdventureWorksServer:8080/tfs/

列出 PWA 的已注册实例

下面的示例列出已注册到 AdventureWorksServer 的 PWA 实例:

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

注册 PWA 实例

下面的示例将 PWAInstance 注册到 AdventureWorksServer:

TfsAdmin ProjectServer /RegisterPWA /pwa:http://PWAServerName/PWAInstance /tfs:http://AdventureWorksServer:8080/tfs/

移除 PWA 实例的注册

下面的示例从 AdventureWorksServer 中移除 PWAInstance 的注册。

TfsAdmin ProjectServer /UnregisterPWA /pwa:http://PWAServerName/PWAInstance/ /tfs:http://AdventureWorksServer:8080/tfs/

返回页首

请参见

其他资源

配置 Team Foundation Server 与 Project Server 的集成

管理 Project Server 与 TFSAdmin ProjectServer 的集成