Zuordnen einer Teamprojektsammlung zu einer Instanz von PWA

Artikel
06/10/2015

Bevor Sie Daten zwischen Visual Studio Team Foundation Server und Microsoft Project Server synchronisieren können, müssen Sie mehrere Aufgaben ausführen, die das Zuordnen einer Teamprojektauflistung zu einer Instanz von Project Web Access oder Projekt Web App (PWA) einschließen. Sie können diese Zuordnung mit den folgenden Optionen des Befehlszeilentools von TFSAdmin verwalten:

/MapPWAToCollection: Ordnet eine Teamprojektauflistung einer Instanz von PWA zu. Sie können einer Instanz mehrere Auflistungen zuordnen, aber Sie können jede Auflistung nur einer Instanz zuordnen. Bevor Sie einer Instanz eine Teamprojektsammlung zuordnen können, müssen Sie die Instanz registrieren.
/GetMappedCollections: Gibt die Liste der Teamprojektauflistungen zurück, die einer Instanz von PWA zugeordnet wurden.
/UnmapPWAFromCollection: Entfernt die Zuordnung einer Teamprojektauflistung von einer Instanz von PWA.

Eine umfassende Übersicht über das Integrieren dieser Produkte 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, muss die Berechtigung Project Server-Integration verwalten für die Teamprojektauflistung auf Zulassen festgelegt sein. Außerdem müssen dem Dienstkonto für Team Foundation Server die erforderlichen Berechtigungen für die Interaktion mit der Instanz von PWA gewährt werden, die in die Datensynchronisierung einbezogen wird. 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 die 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 /GetMappedCollections /tfs:tfsUrl

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

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

Parameter

Parameter	Beschreibung
/tfs:tfsUrl	Gibt die URL (Uniform Resource Locator) eines Anwendungsebenenservers für Team Foundation an. Sie geben die URL im folgenden Format an: http://ServerName:Port/VirtualDirectoryName Wenn Sie kein virtuelles Verzeichnis angeben, geben Sie die URI 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/PWA
/collection:tpcUrl	Gibt die URL einer Teamprojektauflistung an. Sie geben die URL im folgenden Format an: http://ServerName:Port/VirtualDirectoryName/CollectionName Wenn Sie kein virtuelles Verzeichnis angeben, geben Sie die URI im folgenden Format an: http://ServerName:Port/CollectionName
/force	Optional. Nur für die Option /UnmapPWAFromCollection verfügbar. Entfernt alle Zuordnungen für alle Teamprojekte in der Auflistung. Sie sollten diese Option nur angeben, wenn Sie sicher sind, dass sämtliche Teamprojekte in der Auflistung nicht länger an der Datensynchronisierung teilnehmen sollen.
/? oder help	Zeigt Informationen zum Befehl an.

Hinweise

Wenn Sie einen Befehl ausführen, wird eine Meldung angezeigt, die die auszuführende Aktion und das Objekt der Aktion bestätigt. Die folgende Meldung gibt z. B. an, dass die angegebene Instanz von PWA zugeordnet wird:

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

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

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

Die folgenden Vorgänge werden ausgeführt, wenn Sie eine Teamprojektauflistung zuordnen:

Der Speicherortdienst für die Auflistung wird mit der Zuordnung aktualisiert.
Globale Regeln und Felder für die Auflistung werden erstellt.
Das Synchronisierungsmodul wird beim Auftragsdienst registriert.

Bevor Sie die Zuordnung einer Auflistung von einer Instanz von PWA aufheben können, müssen Sie erst die Zuordnung aller Teamprojekte und Enterprise-Projektpläne zur Teamprojektauflistung aufheben. Wenn Projekte zugeordnet werden, wenn Sie die /UnmapPWAFromCollection-Option ausführen, benachrichtigt Sie eine Meldung darüber, dass Sie zuerst die /UnmapPlanFromProject-Option verwenden müssen. Als Alternative können Sie alle Zuordnungen für alle Teamprojekte in der Auflistung mithilfe des /force-Flags entfernen.

Sie können eine Liste zugeordneter Projekte anzeigen, indem Sie die /GetMappedProjects-Option ausführen. Weitere Informationen finden Sie unter Verwalten von Zuordnungen zwischen Enterprise-Projekten und Teamprojekten.

Wenn Sie /UnmapPWAFromCollection für eine Auflistung ausführen, der keine Projekte zugeordnet sind, entfernt der Befehl nicht nur die Zuordnung, sondern auch die globalen Regeln.

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/
URL für die Teamprojektauflistung: http://AdventureWorksServer:8080/tfs/DefaultCollection

Zugeordnete Projektauflistungen auflisten

Im folgenden Beispiel werden die Teamprojektauflistungen aufgeführt, die auf AdventureWorksServer definiert und einer Instanz von PWA zugeordnet sind.

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