共用方式為


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

您必須先執行幾項工作,包括將 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 網站上的下列網頁:使用者帳戶控制

語法

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/

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

下列範例會將 DefaultCollection 對應至 AdventureWorksServer 上定義的 PWAInstance。

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

移除集合的對應

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

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

請參閱

工作

設定 TFS 與 Project Server 整合

概念

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

對應整合元件 [TfsAdmin ProjectServer]