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

發行項
06/10/2015

您必須先執行幾項工作，包括將 Team 專案集合對應到 Project Web Access 或 Project Web App (PWA) 的執行個體，才能同步處理 Visual Studio Team Foundation Server 及 Microsoft Project Server 之間的資料。您可以使用 TFSAdmin 命令列工具的下列選項，管理這個對應：

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

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

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

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

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

需求

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