Registrieren einer Instanz von PWA nach TFS

Artikel
06/10/2015

Bevor Sie Daten zwischen dem Visual Studio Team Foundation Server 2013- und dem Microsoft Project-Server synchronisieren können, müssen Sie mehrere Aspekte der Integration zwischen ihnen konfigurieren. Zuerst müssen Sie die Instanz von Project Web Access oder Projekt Web App (PWA) registrieren, die einen Enterprise-Projektplan mit dem Anwendungsebenenserver unterstützt, der die Teamprojektsauflistung hostet, die ein Teamprojekt enthält. Sie können die Registrierung dieser Instanzen von PWA mit den folgenden Optionen des Befehlszeilentools TfsAdmin ProjectServer verwalten:

/RegisterPWA: Registriert eine Instanz von PWA bei Team Foundation Server.

Wichtig

Beim Aufbau der Verbindung mit Project Server 2010 muss die SharePoint-Webanwendung für die Instanz von PWA auf Klassischer Authentifizierungsmodus festgelegt werden.Sie können die Instanz von PWA nicht registrieren, wenn Sie auf Anspruchsbasierte Authentifizierung festgelegt ist.
/GetRegisteredPWA: Führt die registrierten Instanzen von PWA und die Namen von Servern auf, auf denen Team Foundation Server ausgeführt wird, für das die Instanzen registriert werden.
/UnregisterPWA: Entfernt die registrierte Zuordnung zwischen einer Instanz von PWA und Team Foundation Server. Wenn Sie eine Teamprojektauflistung oder eine Bereitstellung von Team Foundation Server verschieben, können Sie die registrierten Instanzen von PWA entfernen und sie nach der Verschiebung erneut registrieren.

Weitere Informationen zur Konfiguration und Integration von Project Server und Team Foundation Server finden Sie unter Konfigurieren der TFS-Project Server-Integration.

Um das TfsAdmin-Befehlszeilentool zu verwenden, öffnen Sie ein Eingabeaufforderungsfenster, an dem entweder Visual Studio oder Team Explorer installiert ist, und geben Sie Folgendes ein:

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

Ersetzen Sie bei einer 32-Bit-Windows-Edition %programfiles(x86)% durch %programfiles%..

Voraussetzungen

Um diese Befehle zu verwenden, müssen Sie der Gruppe Team Foundation-Administratoren angehören. Um eine Instanz von PWA zu registrieren oder deren Registrierung aufzuheben, müssen Sie auch zur Gruppe Administratoren für die Instanz gehören. Weitere Informationen finden Sie unter Zuweisen von Berechtigungen zum Unterstützen der TFS-Project Server-Integration.

Hinweis

Sie müssen auch dann ein Eingabeaufforderungsfenster mit erhöhten Rechten öffnen, wenn Sie sich mit Administratorrechten anmelden, um diese Funktion auf einem Server nutzen zu können, auf dem Windows Server 2008 ausgeführt wird.Um ein Eingabeaufforderungsfenster mit erhöhten Rechten zu öffnen, wählen Sie Start, öffnen Sie das Kontextmenü für Eingabeaufforderung, und wählen Sie dann Als Administrator ausführen aus.Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Benutzerkontensteuerung.

Syntax

TfsAdmin ProjectServer /GetRegisteredPWA /tfs:tfsUrl

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

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

Parameter

Parameter	Beschreibung
/tfs:tfsUrl	Gibt die URL (Uniform Resource Locator) eines Anwendungsebenenservers für Team Foundation an. Sie geben den URI im folgenden Format an: http://ServerName:Port/VirtualDirectoryName Wenn Sie kein virtuelles Verzeichnis angeben, geben Sie die URL im folgenden Format an: http://ServerName:Port
/pwa:pwaUrl	Gibt die URL einer PWA-Instanz an. Sie geben die URL im folgenden Format an: http://PWAServerName/PWAInstance
/previousPwa:pwaUrl	Gibt die URL an, die zuletzt für eine Instanz von PWA registriert wurde. Wenn sich die URL für ein registriertes PWA ändert, können Sie diesen Schalter für die erneute Registrierung des PWA verwenden. Sie geben die URL im folgenden Format an: http://PWAServerName/PWAInstance
/force	Registriert eine Instanz von PWA bei einem anderen Server, auf dem Team Foundation Server ausgeführt wird, und hebt die Registrierung der Instanz bei dem Server auf, bei dem sie zuletzt registriert war. Wenn Sie beispielsweise eine Projektauflistung auf einen anderen Anwendungsebenenserver verschieben, müssen Sie PWA für die Auflistung auf dem neuen Server erneut registrieren.
/? oder help	Zeigt Informationen zum Befehl an.

Hinweise

Wenn Sie einen TFSAdmin ProjectServer-Befehl ausführen, wird eine Meldung angezeigt, die bestätigt, dass der Befehl ausgeführt wird. Die folgende Meldung gibt z. B. an, dass die Instanz von Project Web Access registriert wird:

Registering PWA http:// PWAServerName/PWAInstance/

Eine andere Meldung wird angezeigt, nachdem der Befehl beendet wurde. Die folgende Meldung gibt z. B. an, dass die Instanz von Project Web Access bei Team Foundation Server registriert wurde:

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

Sie können eine Instanz von PWA nur bei einem Anwendungsebenenserver für Team Foundation registrieren. Sie müssen eine Instanz registrieren, bevor Sie sie einer Teamprojektauflistung zuordnen können. Wenn Sie eine Instanz registrieren, wird der Speicherortdienst für Team Foundation Server mit dieser Information aktualisiert. Außerdem wird die PWA-Instanz mit den benutzerdefinierten Feldern und den Nachschlagetabellen aktualisiert, die für die Integration erforderlich sind.

Wenn Sie einen Registrierungsbefehl ausführen, treten die folgenden Vorgänge auf:

Wenn Sie /RegisterPWA mehr als einmal ausführen und ein Datensatz der Registrierung bereits vorhanden ist, wird die folgende Meldung angezeigt:

The following PWA instance has already been registered: <PWAInstance>.
Wenn Sie /GetRegisteredPWA ausführen, werden die folgenden Informationen angezeigt:
```
The following PWA instances are registered:  
PWA URL 1
PWA URL 2
```
Wenn Sie die /UnRegisterPWA-Option ausführen, entfernt der Befehl nicht nur die zugeordnete Zuordnung, sondern auch die benutzerdefinierten Felder und die Nachschlagetabellen aus der Instanz von PWA.

Beispiele

Die folgenden Werte sind in jedem Beispiel gültig:

URL für die Instanz von PWA: http://PWAServerName/PWAInstance/
URL für Team Foundation Server: http://AdventureWorksServer:8080/tfs/

Auflisten registrierter Instanzen von PWA

Im folgenden Beispiel werden die Instanzen von PWA aufgeführt, die bei AdventureWorksServer registriert sind:

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