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

Artículo
06/10/2015

Para poder sincronizar los datos entre Visual Studio Team Foundation Server y Microsoft Project Server, 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 mediante las siguientes opciones de la herramienta de 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 cada colección solo se puede asignar a 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 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, el permiso Administrar la integración de Project Server para 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 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 /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 formato siguiente: http://ServerName:Port/VirtualDirectoryName Si no especifica un directorio virtual, especifique el URI 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/PWA
/collection:tpcUrl	Especifica la dirección URL de una colección de proyectos de equipo. Especifique la dirección URL con el formato siguiente: http://ServerName:Port/VirtualDirectoryName/CollectionName Si no especifica un directorio virtual, especifique el URI con el siguiente formato: http://ServerName:Port/CollectionName
/force	Opcional. Disponible solamente para la opción /UnmapPWAFromCollection. Quita todas las asignaciones de todos los proyectos de equipo de la colección. 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.

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 se está asignando la instancia especificada de PWA:

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

Aparece otro mensaje 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/.

Al asignar una colección de proyectos de equipo, se realizan las siguientes operaciones:

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 se registra con el servicio de trabajo.

Para poder desasignar una colección de una instancia de PWA, primero debe desasignar todos los proyectos de equipo y planes de proyecto empresarial 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 primero debe utilizar la opción /UnmapPlanFromProject. 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 si ejecuta la opción /GetMappedProjects. Para obtener más información, vea Administrar las asignaciones entre un proyecto empresarial y un proyecto de equipo.

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

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/
Dirección URL para la colección de proyectos de equipo: http://AdventureWorksServer:8080/tfs/DefaultCollection

Hacer una lista de las colecciones de proyectos 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/

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

En el ejemplo siguiente se asigna DefaultCollection a PWAInstance, que se define en AdventureWorksServer.

TfsAdmin ProjectServer /MapPWAToCollection /pwa:http://PWAServerName/PWAInstance /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Quitar la asignación de una colección

En el siguiente ejemplo se quita de PWAInstance la asignación de DefaultCollection.

TfsAdmin ProjectServer /UnmapPWAFromCollection /pwa:http://PWAServerName/PWAInstance /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection