Zuordnen einer Teamprojektsammlung zu einer Instanz von PWA

Artikel
02/26/2013

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

/MapPWAToCollection: Ordnet eine Teamprojektsammlung 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 Teamprojektsammlungen zurück, die einer Instanz von PWA zugeordnet wurden.
/UnmapPWAFromCollection: Entfernt die Zuordnung einer Teamprojektsammlung von einer Instanz von PWA.

Eine umfassende Übersicht über das Integrieren dieser Produkte finden Sie unter Konfigurieren der Integration von Team Foundation Server und Project Server.

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

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

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

Erforderliche Berechtigungen

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

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 erweiterten Rechten zu öffnen, wählen Sie Start, öffnen Sie das Kontextmenü für die Eingabeaufforderung, und wählen Sie anschließend Als Administrator ausführen aus.Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Benutzerkontensteuerung.

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 erweiterten Rechten zu öffnen, wählen Sie Start, öffnen Sie das Kontextmenü für die Eingabeaufforderung, und wählen Sie anschließend 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	Description
/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/NameDesVirtuellenVerzeichnisses 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/Auflistungsname
/force	Dies ist 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.

Zurück nach oben

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, die für die Teamprojektsammlung zugeordnet sind, aufheben.Wenn Projekte zugeordnet werden, wenn Sie die /UnmapPWAFromCollection-Option ausführen, benachrichtigt Sie eine Meldung, 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 den /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.

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

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/