Mapper une collection de projets d'équipe à une instance de PWA

Article
03/04/2013

Avant de synchroniser des données entre Visual Studio Team Foundation Server 2012 et Microsoft Project server, vous devez effectuer plusieurs tâches qui incluent mapper une collection de projets d'équipe à une instance de Project Web Access ou project Web App (PWA).Vous pouvez gérer ce mappage à l'aide des options suivantes de l'outil de ligne de commande TFSAdmin :

/MapPWAToCollection : Mappe une collection de projets d'équipe à une instance de PWA.Vous pouvez mapper plusieurs collections à une instance, mais vous ne pouvez mapper qu'une seule instance à chaque collection.Avant de mapper une collection à une instance, vous devez enregistrer l'instance.
/GetMappedCollections : Renvoie la liste des collections de projets d'équipe qui ont été mappées à une instance de PWA.
/UnmapPWAFromCollection : Enlève le mappage d'une collection de projets d'équipe d'une instance de PWA.

Pour une présentation de bout en bout sur l'intégration de ces produits, consultez Configurer l'intégration de Team Foundation Server et Project Server.

Pour utiliser l'outil en ligne de commande des TFSAdmin , ouvrez une fenêtre d'invite de commandes où Visual Studio ou Team Explorer est installé et entrez :

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

Sur une édition 64 bits de Windows, remplacez %programfiles% par %programfiles(x86)%.

Autorisations requises

Pour utiliser ces commandes, votre autorisation Administrer pour l'intégration Project Server de la collection de projets d'équipe doit avoir la valeur Autoriser.En outre, le compte de service de Team Foundation Server doit disposer des autorisations requises pour interagir avec l'instance de PWA qui fait partie de la synchronisation de données.Pour plus d’informations, consultez Assigner des autorisations pour prendre en charge l'intégration entre Project Server et Team Foundation Server.

[!REMARQUE]

Même si vous vous connectez avec des autorisations d'administration, vous devez ouvrir une fenêtre d'invite de commandes avec élévation de privilèges pour exécuter cette fonction sur un serveur Windows Server 2008.Pour ouvrir une fenêtre d'invite de commandes avec élévation de privilèges, sélectionnez Démarrer, ouvrez le menu contextuel Invite de commandes, puis sélectionnez Exécuter en tant qu'administrateur.Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Contrôle de compte d'utilisateur.

Syntaxe

TfsAdmin ProjectServer /GetMappedCollections /tfs:tfsUrl 

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

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

Paramètres

Paramètre	Description
/tfs:tfsUrl	Spécifie l'adresse Web (URL) d'un serveur de couche Application pour Team Foundation.Spécifiez l'URL au format suivant : http://NomServeur:Port/NomRépertoireVirtuel Si vous ne spécifiez pas de répertoire virtuel, indiquez l'URI au format suivant : http://NomServeur:Port
/pwa:pwaUrl	Spécifie l'URL d'une instance de PWA.Spécifiez l'URL au format suivant : http://NomServeurPWA/PWA
/collection:tpcUrl	Spécifie l'URL d'une collection du projet d'équipe.Spécifiez l'URL au format suivant : http://NomServeur:Port/NomRépertoireVirtuel/NomCollection Si vous ne spécifiez pas de répertoire virtuel, indiquez l'URI au format suivant : http://NomServeur:Port/NomCollection
/force	Optionnel.Disponible pour l'option /UnmapPWAFromCollection uniquement.Supprime tous les mappages de tous les projets d'équipe dans la collection.Vous ne devez spécifier cette option que si vous êtes sûr de ne plus avoir besoin de projets d'équipe dans la collection pour faire partie de la synchronisation de données.
/? ou help	Affiche des informations sur la commande.

Retour au début

Notes

Lorsque vous exécutez une commande, un message apparaît et confirme l'action en cours d'exécution et l'objet de l'action.Par exemple, le message suivant indique que l'instance spécifiée de PWA est en cours de mappage :

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

Un autre message apparaît à l'issue de l'exécution de la commande.Par exemple, le message suivant indique que l'instance de PWA a été enregistrée avec Team Foundation Server :

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

Les opérations suivantes sont exécutées lorsque vous mappez une collection de projets d'équipe :

Le service d'emplacement pour la collection est mis à jour avec le mappage.
Des règles globales et les champs de la collection sont créés.
Le moteur de synchronisation est enregistré avec le service de travail.

Avant de pouvoir annuler le mappage entre une collection et une instance de PWA, vous devez d'abord annuler le mappage de tous les projets d'équipe et les plans de projet d'entreprise mappés pour la collection de projets d'équipe.Si des projets sont mappés lorsque vous exécutez l'option /UnmapPWAFromCollection, un message vous informe que vous devez d'abord utiliser l'option /UnmapPlanFromProject.Comme autre solution, vous pouvez utiliser l'indicateur /force pour supprimer tous les mappages de tous les projets d'équipe dans la collection.

Vous pouvez afficher une liste de projets mappés en exécutant l'option /GetMappedProjects.Pour plus d’informations, consultez Gérer des mappages entre un plan de projet d'entreprise et un projet d'équipe.

Si vous exécutez /UnmapPWAFromCollection sur une collection à laquelle aucun projet n'est mappé, la commande supprime non seulement le mappage mais également les règles globales.

Retour au début

Exemples

Les valeurs suivantes s'appliquent dans chaque exemple :

URL de l'instance de PWA : http:// NomServeurPWA/InstancePWA/
URL pour Team Foundation Server : http://AdventureWorksServer:8080/tfs/
URL de la collection de projets d'équipe : http://AdventureWorksServer:8080/tfs/DefulatCollection

Liste des collections de projets mappées

L'exemple suivant répertorie les collections de projets d'équipe qui sont définies sur AdventureWorksServer et qui sont mappées à une instance de PWA.

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