Enregistrer une instance de PWA dans TFS

Article
06/10/2015

Avant de synchroniser les données entre les serveurs Visual Studio Team Foundation Server 2013 et Microsoft Project, vous devez d'abord configurer plusieurs points d'intégration entre eux. D'abord, vous devez enregistrer l'instance de Project Web Access ou Project Web App (PWA) qui prend en charge un plan de projet d'entreprise avec le serveur de couche Application qui héberge la collection de projets d'équipe qui contient un projet d'équipe. Vous pouvez gérer l'enregistrement de ces instances de PWA à l'aide des options suivantes de l'outil de ligne de commande TfsAdmin ProjectServer:

/RegisterPWA : Enregistre une instance de PWA à Team Foundation Server.

Important

Lors de la connexion à Project Server 2010, l'application Web SharePoint pour l'instance de PWA doit être définie avec la valeur Authentification en mode classique.Vous ne pourrez pas inscrire l'instance de PWA si elle a la valeur Authentification basée sur les revendications.
/GetRegisteredPWA: Répertorie les instances enregistrées de PWA et les noms des serveurs qui exécutent Team Foundation Server auquel les instances sont enregistrées.
/UnregisterPWA : Enlève l'association enregistrée entre une instance de PWA et Team Foundation Server. Lorsque vous déplacez une collection de projets d'équipe ou un déploiement de Team Foundation Server, vous pouvez supprimer les instances enregistrées de PWA, puis les ré-enregistrer après le déplacement.

Pour plus d'informations sur la configuration et l'intégration de Project Server et Team Foundation Server, consultez Configurer l'intégration de TFS et Project Server.

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

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

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

Configuration requise

Pour utiliser ces commandes, vous devez appartenir au groupe Team Foundation Administrators . Pour inscrire ou désinscrire une instance PWA, vous devez également appartenir au groupe Administrateurs relatif à cette instance. Pour plus d'informations, consultez Accorder les autorisations pour prendre en charge l'intégration de TFS et Project Server.

Notes

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 du site Web Microsoft : Contrôle de l'accès utilisateur.

Syntaxe

TfsAdmin ProjectServer /GetRegisteredPWA /tfs:tfsUrl

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

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

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'URI au format suivant : http://ServerName:Port/VirtualDirectoryName Si vous ne spécifiez pas de répertoire virtuel, indiquez l'URL sous la forme suivante : http://ServerName:Port
/pwa:pwaUrl	Spécifie l'URL d'une instance de PWA. Spécifiez l'URL au format suivant : http://PWAServerName/PWAInstance
/previousPwa:pwaUrl	Spécifie l'URL enregistrée en dernier pour une instance de PWA. Lorsque l'URL d'un PWA enregistré change, vous pouvez utiliser ce commutateur pour ré-enregistrer PWA. Spécifiez l'URL au format suivant : http://PWAServerName/PWAInstance
/force	Enregistre une instance de PWA avec un autre serveur qui exécute Team Foundation Server, et annule l'enregistrement de l'instance sur le serveur sur lequel a été enregistrée en dernier. Par exemple, lorsque vous déplacez une collection de projets d'un serveur de couche Application, vous devez ré-enregistrer l'instance de PWA de la collection auprès du nouveau serveur.
/? ou help	Affiche des informations sur la commande.

Notes

Lorsque vous exécutez une commande TFSAdmin ProjectServer, un message s'affiche et confirme que la commande est en cours d'exécution. Par exemple, le message suivant indique que l'instance de Project Web Access est en cours d'enregistrement :

Registering PWA http:// PWAServerName/PWAInstance/

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

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

Vous pouvez enregistrer une instance de PWA auprès d'un seul serveur de couche Application pour Team Foundation. Vous devez enregistrer une instance avant de l'associer à une collection de projets d'équipe. Lorsque vous enregistrez une instance, le service d'emplacement de Team Foundation Server est mis à jour avec ces informations. En outre, l'instance de PWA est mise à jour avec les champs personnalisés et les tables de recherche requis par l'intégration.

Lorsque vous exécutez une commande d'enregistrement, les opérations suivantes se produisent :

Si vous exécutez /RegisterPWA plus d'une fois et qu'un enregistrement existe déjà, le message suivant s'affiche :

The following PWA instance has already been registered: <PWAInstance>.
Lorsque vous exécutez /GetRegisteredPWA, les informations suivantes apparaissent :
```
The following PWA instances are registered:  
PWA URL 1
PWA URL 2
```
Lorsque vous exécutez l'option /UnRegisterPWA, la commande supprime non seulement l'association mappée, mais également les champs et les tables de recherche personnalisés de l'instance de PWA.

Exemples

Les valeurs suivantes s'appliquent dans chaque exemple :

URL de l'instance de PWA : http://PWAServerName/PWAInstance/
URL pour Team Foundation Server : http://AdventureWorksServer:8080/tfs/

Liste des instances enregistrées de PWA

L'exemple suivant répertorie les instances de PWA qui sont enregistrés sur AdventureWorksServer :

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