將 Team 專案集合對應至 PWA 執行個體

發行項
02/28/2013

在您可以同步處理 Visual Studio Team Foundation Server 2012 與 Microsoft Project Server 之間的資料之前，您必須執行包括將 Team 專案集合對應至 Project Web Access 或 Project Web App App 數個工作。您可以使用 TFSAdmin 命令列工具的下列選項，管理這個對應：

/MapPWAToCollection：將 Team 專案集合對應至 PWA 的執行個體。您可以將多個集合對應到一個執行個體，但每個集合只能對應到一個執行個體。您必須先註冊執行個體，才能將集合對應至該執行個體。
/GetMappedCollections：傳回已對應至 PWA 執行個體的 Team 專案集合清單。
/UnmapPWAFromCollection：從 PWA 的執行個體移除 Team 專案集合的對應。

如需這些產品整合方式的端對端概觀，請參閱設定 Team Foundation Server 和 Project Server 的整合。

若要使用 TFSAdmin 命令列工具，請開啟 Visual Studio 或 Team Explorer 安裝的命令提示字元] 視窗並輸入:

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

在 Windows 64 位元版本中，將 %programfiles% 取代為 %programfiles(x86)%。

必要的使用權限

若要使用這些命令，Team 專案集合的 [管理 Project Server 整合] 使用權限必須設定為 [允許]。而且必須將必要權限授與 Team Foundation Server 服務帳戶，以便和將參與資料同步處理的 PWA 執行個體進行互動。如需詳細資訊，請參閱指派權限以支援 Project Server 和 Team Foundation Server 的整合。

注意事項
即使您使用系統管理權限登入，還是必須開啟較高權限的命令提示字元視窗，在執行 Windows Server 2008 的伺服器上執行此功能。若要開啟較高權限的 [命令提示字元] 視窗，請選取 [開始]，開啟 [命令提示字元]捷徑功能表，然後選取 [以系統管理員身分執行。]。如需詳細資訊，請參閱下列 Microsoft 網站的網頁：使用者存取控制。

即使您使用系統管理權限登入，還是必須開啟較高權限的命令提示字元視窗，在執行 Windows Server 2008 的伺服器上執行此功能。若要開啟較高權限的 [命令提示字元] 視窗，請選取 [開始]，開啟 [命令提示字元]捷徑功能表，然後選取 [以系統管理員身分執行。]。如需詳細資訊，請參閱下列 Microsoft 網站的網頁：使用者存取控制。

語法

TfsAdmin ProjectServer /GetMappedCollections /tfs:tfsUrl 

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

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

參數

參數	描述
/tfs:tfsUrl	指定 Team Foundation 的應用程式層伺服器的統一資源定位器 (URL)。您可以使用下列格式指定 URL： http://ServerName:Port/VirtualDirectoryName 如果您未指定虛擬目錄，則可以使用下列格式指定 URI： http://ServerName:Port
/pwa:pwaUrl	指定 PWA 執行個體的 URL。您可以使用下列格式指定 URL： http://PWAServerName/PWA
/collection:tpcUrl	指定 Team 專案集合的 URL。您可以使用下列格式指定 URL： http://ServerName:Port/VirtualDirectoryName/CollectionName 如果您未指定虛擬目錄，則可以使用下列格式指定 URI： http://ServerName:Port/CollectionName
/force	選擇項。僅適用於 /UnmapPWAFromCollection 選項。移除集合中所有 Team 專案的所有對應。只有在您確定不再需要集合中的任何 Team 專案繼續參與資料同步處理時，才應該指定這個選項。
/? 或 help	顯示命令的相關資訊。

回到頁首

備註

執行命令時會顯示訊息，確認正在執行的動作以及動作的物件。例如，下列訊息表示正在對應 PWA 的特定執行個體：

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

命令完成後，會出現另一個訊息。例如，下列訊息表示已經向 Team Foundation Server 註冊 PWA 的執行個體：

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

對應 Team 專案集合時，會執行下列作業：

集合的位置服務會以對應來更新。
已建立集合上的全域規則和欄位。
同步處理引擎會使用工作服務註冊。

您必須先取消所有 Team 專案與對應於 Team 專案集合之企業專案計劃的對應，才能取消 PWA 執行個體與集合的對應。如果執行 /UnmapPWAFromCollection 選項時專案已對應，則會有訊息告知您必須先使用 /UnmapPlanFromProject 選項。或者，您可以使用 /force 旗標移除集合中所有 Team 專案的所有對應。

您可以執行 /GetMappedProjects 選項，以顯示對應的專案清單。如需詳細資訊，請參閱管理企業專案與 Team 專案之間的對應。

如果您在沒有專案對應的集合上執行 /UnmapPWAFromCollection，此命令不僅會移除對應，也會移除全域規則。

回到頁首

範例

每個範例中會套用下列值：

PWA 執行個體的 URL：http://PWAServerName/PWAInstance/
Team Foundation Server 的 URL：http://AdventureWorksServer:8080/tfs/
Team 專案集合的 URL:http://AdventureWorksServer:8080/tfs/DefulatCollection

列出已對應的專案集合

下面範例會列出定義於 AdventureWorksServer 且對應至 PWA 執行個體的 Team 專案集合。

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