向 Team Foundation Server 註冊 PWA 執行個體
您先必須設定 Visual Studio Team Foundation Server 2010 與 Microsoft Project Server 2007 或 Project Server 2010 之間的數個整合點,才能同步處理兩者之間的資料。 首先,您必須向裝載包含 Team 專案之 Team 專案集合的應用程式層伺服器,註冊支援企業專案計劃之 Project Web Access 或 Project Web App (PWA) 的執行個體。 您可以使用 TFSAdmin ProjectServer 命令列工具的下列選項,管理 PWA 的這些執行個體的註冊:
/RegisterPWA:將 PWA 的執行個體註冊到 Team Foundation Server。
/GetRegisteredPWA:列出 PWA 的已註冊執行個體以及正在執行該執行個體所註冊之 Team Foundation Server 的伺服器名稱。
/UnregisterPWA:移除 PWA 執行個體和 Team Foundation Server 之間的註冊關聯。 當您移動 Team 專案集合或 Team Foundation Server 部署時,可以移除 PWA 的已註冊執行個體,並在移動後重新加以註冊。
如需設定及整合 Project Server 和 Team Foundation Server 的詳細資訊,請參閱設定 Team Foundation Server 和 Project Server 的整合。
若要使用 TFSAdmin命令列工具,請在執行 Team 總管 和 Visual Studio Team Foundation Server 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 Foundation Administrators] 群組。 若要註冊或取消註冊 PWA 執行個體,您也必須屬於該執行個體的 [Administrators] 群組。 如需詳細資訊,請參閱指派權限以支援 Project Server 和 Team Foundation Server 的整合。
注意事項 |
---|
即使您使用系統管理權限登入,還是必須開啟較高權限的命令提示字元視窗,在執行 Windows Server 2008 的伺服器上執行此功能。 若要開啟更高權限的 [命令提示字元] 視窗,請按一下 [開始],並以滑鼠右鍵按一下 [命令提示字元],然後按一下 [以系統管理員身分執行]。 如需詳細資訊,請參閱下列 Microsoft 網站的網頁:使用者存取控制。 |
語法
TfsAdmin ProjectServer /GetRegisteredPWA /tfs:tfsUrl
TfsAdmin ProjectServer /RegisterPWA /pwa:pwaUrl /tfs:tfsUrl [/previousPwa:pwaUrl] [/force]
TfsAdmin ProjectServer /UnregisterPWA /pwa:pwaUrl /tfs:tfsUrl
參數
參數 |
描述 |
---|---|
/tfs:tfsUrl |
指定 Team Foundation 的應用程式層伺服器的統一資源定位器 (URL)。 您可以使用下列格式指定 URI: http://ServerName:Port/VirtualDirectoryName 如果您未指定虛擬目錄,請指定下列格式的 URL: http://ServerName:Port |
/pwa:pwaUrl |
指定 PWA 執行個體的 URL。 您可以使用下列格式指定 URL: http://PWAServerName/PWAInstance |
/previousPwa:pwaUrl |
指定上次為 PWA 執行個體所註冊的 URL。 當已註冊之 PWA 的 URL 變更時,您可以使用這個參數重新註冊 PWA。 您可以使用下列格式指定 URL: http://PWAServerName/PWAInstance |
/force |
向另一個執行 Team Foundation Server 的伺服器註冊 PWA 執行個體,並在上次註冊的伺服器中取消註冊執行個體。 例如,當您將專案集合移至另一個應用程式層伺服器時,必須在新伺服器中為集合重新註冊 PWA。 |
/? 或 help |
顯示命令的相關資訊。 |
回到頁首
備註
執行 TFSAdmin ProjectServer 命令時會顯示訊息,確認正在執行此命令。 例如,下列訊息表示正在註冊 Project Web Access 的執行個體:
Registering PWA http:// PWAServerName/PWAInstance/
命令完成後,會出現另一個訊息。 例如,下列訊息表示已經向 Team Foundation Server 註冊 Project Web Access 的執行個體:
You have successfully registered PWA http://PWAServerName/PWAInstance/
您只可以向一個 Team Foundation 應用程式層伺服器註冊一個 PWA 的執行個體。 您必須先註冊執行個體,才能將它與 Team 專案集合產生關聯。 註冊執行個體時,Team Foundation Server 的位置服務會更新為該資訊。 另外,PWA 執行個體會更新為整合所需的自訂欄位和查閱資料表。
執行註冊命令時,會發生下列作業:
如果您不只一次執行 /RegisterPWA,而且註冊的記錄已經存在,則會出現下列訊息:
The following PWA instance has already been registered: <PWAInstance>.
當您執行 /GetRegisteredPWA 時,就會出現下列資訊:
The following PWA instances are registered: PWA URL 1 PWA URL 2
您在執行 /UnRegisterPWA 選項時,命令不只會移除對應的關聯,也會從 PWA 的執行個體移除自訂欄位及查閱表格。
回到頁首
範例
每個範例中會套用下列值:
PWA 的執行個體 URL:http://PWAServerName/PWAInstance/
Team Foundation Server 的 URL:http://AdventureWorksServer:8080/tfs/
列出 PWA 的已註冊執行個體
下列範例會列出註冊到 AdventureWorksServer 的 PWA 執行個體:
TfsAdmin ProjectServer /GetRegisteredPWA /tfs:http://AdventureWorksServer:8080/tfs/
註冊 PWA 執行個體
下列範例會將 PWAInstance 註冊至 AdventureWorksServer:
TfsAdmin ProjectServer /RegisterPWA /pwa:http://PWAServerName/PWAInstance /tfs:http://AdventureWorksServer:8080/tfs/
移除 PWA 執行個體的註冊
下列範例會從 AdventureWorksServer 移除 PWAInstance 的註冊:
TfsAdmin ProjectServer /UnregisterPWA /pwa:http://PWAServerName/PWAInstance/ /tfs:http://AdventureWorksServer:8080/tfs/
回到頁首