Registrieren einer Instanz von PWA bei Team Foundation Server

Artikel
07/20/2011

Bevor Sie Daten zwischen Visual Studio Team Foundation Server 2010 und Microsoft Project Server 2007 oder Project Server 2010 synchronisieren können, müssen Sie zuerst mehrere Punkte 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 Teamprojektsammlung 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.
/GetRegisteredPWA: Führt die registrierten Instanzen von PWA und die Namen von Servern auf, die Team Foundation Server ausführen, für die die Instanzen registriert werden.
/UnregisterPWA: Entfernt die registrierte Zuordnung zwischen einer Instanz von PWA und Team Foundation Server. Wenn Sie eine Teamprojektsammlung 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 Integration von Team Foundation Server und Project Server.

Um das Befehlszeilentool TFSAdmin zu verwenden, öffnen Sie ein Eingabeaufforderungsfenster auf einem Computer, der Team Explorer und Service Pack 1 für Visual Studio Team Foundation Server 2010 ausführt. Führen Sie das Tool im folgenden Verzeichnis aus: Laufwerk:\Programme\Microsoft Visual Studio 10.0\Common7\IDE. Bei 64-Bit-Computern befindet sich das Tool im Verzeichnis Laufwerk:\Programme (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

Erforderliche Berechtigungen

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 für die Unterstützung der Integration von Project Server und Team Foundation Server.

Tipp

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. Klicken Sie zum Öffnen eines Eingabeaufforderungsfensters mit erhöhten Rechten auf Start, klicken Sie mit der rechten Maustaste auf Eingabeaufforderung, und klicken Sie dann auf Als Administrator ausführen. 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	Beschreibungen
/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/NameDesVirtuellenVerzeichnisses 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/PWAInstanz
/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/PWAInstanz
/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 Projektsammlung auf einen anderen Anwendungsebenenserver verschieben, müssen Sie PWA für die Sammlung auf dem neuen Server erneut registrieren.
/? oder help	Zeigt Informationen zum Befehl an.

Zurück nach oben

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 Teamprojektsammlung zuordnen können. Wenn Sie eine Instanz registrieren, wird der Speicherortdienst für Team Foundation Server mit dieser Information aktualisiert. Außerdem wird die Instanz von PWA 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 mehr als einmal /RegisterPWA 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.

Zurück nach oben

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/

Registrierte Instanzen von PWA auflisten

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

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