Asignar una colección de proyectos de equipo a una instancia de PWA

Artículo
08/10/2011

Para poder sincronizar los datos entre Visual Studio Team Foundation Server 2010 y Microsoft Project Server 2007 con Service Pack 2 o (SP2) Project Server 2010, debe realizar varias tareas que incluyen la asignación de una colección de proyectos de equipo a una instancia de Project Web Access o Project Web App (PWA). Puede administrar esta asignación utilizando las siguientes opciones de la herramienta de la línea de comandos TFSAdmin:

/MapPWAToCollection: asigna una colección de proyectos de equipo a una instancia de PWA. Puede asignar varias colecciones a una instancia, pero puede asignar cada colección a solo una instancia. Para poder asignar una colección a una instancia, debe registrar la instancia.
/GetMappedCollections: devuelve la lista de colecciones de proyectos de equipo asignadas a una instancia de PWA.
/UnmapPWAFromCollection: quita la asignación de una colección de proyectos de equipo de una instancia de PWA.

Para obtener información completa acerca de cómo integrar estos productos, vea Configurar la integración de Team Foundation Server y Project Server.

Para utilizar la herramienta de la línea de comandos TFSAdmin, abra una ventana del símbolo del sistema en un equipo que ejecute Team Explorer y Service Pack 1 para Visual Studio 2010. Ejecute la herramienta desde el siguiente directorio: Unidad:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE. En equipos de 64 bits, la herramienta se encuentra en Unidad:\Archivos de programa (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

Permisos necesarios

Para utilizar estos comandos, su permiso Administrar la integración de Project Server de la colección de proyectos de equipo debe estar establecido en Permitir. Asimismo, se deben conceder a la cuenta de servicio de Team Foundation Server los permisos necesarios para interactuar con la instancia de PWA que participará en la sincronización de datos. Para obtener más información, vea Asignar permisos para la integración de Team Foundation Server 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 de símbolo del sistema con permisos elevados, haga clic en Inicio, haga clic con el botón secundario en Símbolo del sistema y, a continuación, haga clic en 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 /GetMappedCollections /tfs:tfsUrl 

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

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

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 la dirección URL con el siguiente formato: http://NombreServidor:Puerto/NombreDirectorioVirtual Si no especifica un directorio virtual, debe especificar el identificador URI con el formato siguiente: http://NombreServidor:Puerto
/pwa:pwaUrl	Especifica la dirección URL de una instancia de PWA. Especifique la dirección URL con el siguiente formato: http://NombreServidorPWA/PWA
/collection:tpcUrl	Especifica la dirección URL de una colección de proyectos de equipo. Especifique la dirección URL con el siguiente formato: http://NombreServidor:Puerto/NombreDirectorioVirtual/NombreColección Si no especifica un directorio virtual, debe especificar el identificador URI con el formato siguiente: http://NombreServidor:Puerto/NombreColección
/force	Opcional. Disponible solamente para la opción /UnmapPWAFromCollection. Quita todas las asignaciones de todos los proyectos de equipo de la colección. No puede desasignar una colección que tiene algún proyecto de equipo asignado. Solo debería especificar esta opción si está seguro de que ya no desea que ningún proyecto de equipo de la colección siga participando en la sincronización de datos.
/? o help	Muestra información sobre el comando.

Volver al principio

Comentarios

Al ejecutar un comando, aparece un mensaje y confirma la acción que se realiza y el objeto de la acción. Por ejemplo, el siguiente mensaje indica que la instancia especificada de PWA se está asignando:

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

Otro mensaje aparece cuando el comando finaliza. Por ejemplo, el siguiente mensaje indica que la instancia de PWA se ha registrado con Team Foundation Server:

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

Se realizan las siguientes operaciones al asignar una colección de proyectos de equipo:

El servicio de ubicación de la colección se actualiza con la asignación.
Se crean reglas globales y campos en la colección.
El motor de sincronización está registrado con el servicio del trabajo.

Para poder desasignar una colección de una instancia de PWA, primero debe desasignar todos los proyectos de equipo y planes de proyecto de empresa que están asignados para la colección de proyectos de equipo. Si se asignan proyectos al ejecutar la opción /UnmapPWAFromCollection, un mensaje notifica que debe utilizar la opción /UnmapPlanFromProject primero. Como alternativa, puede utilizar la marca /force para quitar todas las asignaciones de todos los proyectos de equipo de la colección.

Puede mostrar una lista de proyectos asignados ejecutando la opción /GetMappedProjects. Para obtener más información, vea Administrar asignaciones entre proyectos de equipo y proyectos empresariales.

Si ejecuta /UnmapPWAFromCollection en una colección a la que no está asignado ningún proyecto, el comando no solo quita la asignación sino también las reglas globales.

Volver al principio

Ejemplos

Los siguientes valores se aplican en cada ejemplo:

Dirección URL de la instancia de PWA: http:// NombreDeServidorPWA/InstanciaPWA/
Dirección URL de Team Foundation Server: http://AdventureWorksServer:8080/tfs/
Identificador URL de la colección de proyectos de equipo: http://AdventureWorksServer:8080/tfs/Collection0

Enumerar las colecciones de proyectos que están asignadas

En el siguiente ejemplo se muestran las colecciones de proyectos de equipo que se definen en AdventureWorksServer y que están asignadas a una instancia de PWA.

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