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

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

  • /MapPWAToCollection:將 Team 專案集合對應至 PWA 的執行個體。 您可以將多個集合對應到一個執行個體,但每個集合只能對應到一個執行個體。 您必須先註冊執行個體,才能將集合對應至該執行個體。

  • /GetMappedCollections:傳回已對應至 PWA 執行個體的 Team 專案集合清單。

  • /UnmapPWAFromCollection:從 PWA 的執行個體移除 Team 專案集合的對應。

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

若要使用 TFSAdmin命令列工具,請在執行 Team 總管 和 Visual Studio 2010 Service Pack 1 的電腦上開啟命令提示字元視窗。您可以在下列目錄中執行此工具:磁碟機:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE。 若是 64 位元電腦,此工具位於 Drive:\Program Files (x86)\Microsoft Visual Studio 10.0\Common7\IDE。

必要的使用權限

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

注意事項注意事項

即使您使用系統管理權限登入,還是必須開啟較高權限的命令提示字元視窗,在執行 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 專案的集合。 只有在您確定不再需要集合中的任何 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/Collection0

列出已對應的專案集合

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

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

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

下列範例將 Collection0 對應至定義於 AdventureWorksServer 的 PWAInstance。

TfsAdmin ProjectServer /MapPWAToCollection /pwa:http://PWAServerName/PWAInstance /collection:http://AdventureWorksServer:8080/tfs/Collection0

移除集合的對應

下列範例會從 PWAInstance 移除 Collection0 的對應。

TfsAdmin ProjectServer /UnmapPWAFromCollection /pwa:http://PWAServerName/PWAInstance /collection:http://AdventureWorksServer:8080/tfs/Collection0

回到頁首

請參閱

其他資源

設定 Team Foundation Server 和 Project Server 的整合

移除元件使其不再參與資料同步處理

使用 TFSAdmin ProjectServer 管理 Project Server 整合