Registrar una instancia de PWA en TFS

Artículo
06/10/2015

Para poder sincronizar los datos entre Visual Studio Team Foundation Server 2013 y Microsoft Project Server, debe configurar varios puntos de integración entre ellos. Primero, debe registrar la instancia de Project Web Access o Project Web App (PWA) que admite un plan de proyecto empresarial con el servidor de la capa de aplicación que hospeda la colección de proyectos de equipo que contiene un proyecto de equipo. Puede administrar el registro de estas instancias de PWA mediante las siguientes opciones de la herramienta de línea de comandos TfsAdmin ProjectServer:

/RegisterPWA: registra una instancia de PWA en Team Foundation Server.

Importante

Cuando se conecte a Project Server 2010, la aplicación web de SharePoint para la instancia de PWA debe establecerse en Autenticación de modo clásico.No podrá registrar la instancia de PWA si se establece en Autenticación basada en notificaciones.
/GetRegisteredPWA: hace una lista de las instancias de PWA registradas y de los nombres de los servidores que están ejecutando Team Foundation Server en los que están registradas esas instancias.
/UnregisterPWA: quita la asociación registrada entre una instancia de PWA y Team Foundation Server. Al mover una colección de proyectos de equipo o una implementación de Team Foundation Server, puede quitar las instancias registradas de PWA y, a continuación, registrarlas de nuevo después de mover la colección.

Para obtener más información sobre la configuración e integración de Project Server y Team Foundation Server, vea Configurar la integración de TFS y Project Server.

Para usar la herramienta de línea de comandos TfsAdmin, abra una ventana del símbolo del sistema donde se haya instalado Visual Studio o Team Explorer y escriba:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

En una edición de Windows de 32 bits, reemplace %programfiles(x86)% por %programfiles%..

Requisitos

Para utilizar estos comandos, debe pertenecer al grupo Team Foundation Administrators. Para registrarse o eliminar del Registro una instancia de PWA, debe pertenecer también al grupo Administradores para la instancia. Para obtener más información, vea Asignar permisos para la integración de TFS y Project Server.

Nota

Incluso si ha iniciado sesión con permisos administrativos, debe abrir una ventana de símbolo del sistema con privilegios elevados para ejecutar esta función en un servidor que ejecute Windows Server 2008.Para abrir una ventana del símbolo del sistema con privilegios elevados, elija Inicio, abra el menú contextual de Símbolo del sistema y, a continuación, elija Ejecutar como administrador.Para obtener más información, vea la página siguiente en el sitio web de Microsoft: Control de cuentas de usuario.

Sintaxis

TfsAdmin ProjectServer /GetRegisteredPWA /tfs:tfsUrl

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

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

Parámetros

Parámetro	Descripción
/tfs:tfsUrl	Especifica el localizador uniforme de recursos (URL) de un servidor de la capa de aplicación de Team Foundation. Especifique el URI con el formato siguiente: http://ServerName:Port/VirtualDirectoryName Si no especifica un directorio virtual, especifique la dirección URL con el siguiente formato: http://ServerName:Port
/pwa:pwaUrl	Especifica la dirección URL de una instancia de PWA. Especifique la dirección URL con el formato siguiente: http://PWAServerName/PWAInstance
/previousPwa:pwaUrl	Especifica la dirección URL que se registró más recientemente para una instancia de PWA. Cuando la dirección URL cambia para una instancia de PWA registrada, puede utilizar este modificador para volver a registrar la instancia de PWA. Especifique la dirección URL con el formato siguiente: http://PWAServerName/PWAInstance
/force	Registra una instancia de PWA con un servidor diferente que ejecuta Team Foundation Server y anula el registro de la instancia del servidor en el que se registró más recientemente. Por ejemplo, cuando mueve una colección de proyectos a otro servidor de la capa de aplicación, debe volver a registrar la instancia de PWA para la colección con el nuevo servidor.
/? o help	Muestra información sobre el comando.

Comentarios

Al ejecutar un comando de TFSAdmin ProjectServer, aparece un mensaje que confirma que el comando se está ejecutando. Por ejemplo, el siguiente mensaje indica que la instancia de Project Web Access se está registrando:

Registering PWA http:// PWAServerName/PWAInstance/

Aparece otro mensaje cuando el comando finaliza. Por ejemplo, el siguiente mensaje indica que la instancia de Project Web Access se ha registrado con Team Foundation Server:

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

Puede registrar una instancia de PWA con un solo servidor de la capa de aplicación para Team Foundation. Debe registrar una instancia para poder asociarla a una colección de proyectos de equipo. Al registrar una instancia, el servicio de ubicación de Team Foundation Server se actualiza con esa información. Además, la instancia de PWA se actualiza con los campos personalizados y las tablas de búsqueda que la integración requiere.

Al ejecutar un comando de registro, se producen las operaciones siguientes:

Si ejecuta /RegisterPWA más de una vez y ya existe una grabación del registro, aparece el mensaje siguiente:

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

Al ejecutar /GetRegisteredPWA, aparece la información siguiente:

The following PWA instances are registered:  
PWA URL 1
PWA URL 2

Al ejecutar la opción /UnRegisterPWA, el comando no solo quita la asociación asignada, sino también los campos personalizados y las tablas de búsqueda de la instancia de PWA.

Ejemplos

En cada ejemplo se aplican los valores siguientes:

Dirección URL de la instancia de PWA: http://PWAServerName/PWAInstance/
Dirección URL de Team Foundation Server: http://AdventureWorksServer:8080/tfs/

Hacer una lista de las instancias registradas de PWA

En el ejemplo siguiente se muestran las instancias de PWA registradas en AdventureWorksServer:

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