管理企業專案與 Team 專案之間的對應

在您可以同步處理 Visual Studio Team Foundation Server 2012 和 Microsoft Project 伺服器之間的資料前，您必須執行包含關聯企業專案計劃與 Team 專案的工作。如需如何整合這兩個產品的概觀，請參閱設定 Team Foundation Server 和 Project Server 的整合。

您可以在 TfsAdmin ProjectServer 命令列工具中使用下列命令，管理 Team Foundation Server 中企業專案計劃與 Team 專案的關聯：

• /MapPlanToTeamProject：對應企業專案計劃至 Team 專案。您可以將多個計劃對應到相同的 Team 專案，但是每個計劃只能對應到一個 Team 專案。

• /GetMappedProjects：傳回企業專案計劃清單，這些計劃會對應到您所指定之小組專案集合中的任何 Team 專案。

• /UnmapPlanFromTeamProject：移除企業專案計劃與 Team 專案之間的對應。

注意事項
將企業專案計劃對應至 Team 專案之後，您可以變更進行同步處理的工作項目類型。如需詳細資訊，請參閱管理可用於同步處理的工作項目類型。

若要使用 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 網站上的下列網頁：使用者存取控制。

語法

TfsAdmin ProjectServer /GetMappedProjects /collection:tpcUrl

TfsAdmin ProjectServer /MapPlanToTeamProject /collection:tpcUrl /enterpriseProject:EnterpriseProjectName /teamProject:TeamProjectName [/workItemTypes:ListOfWorkItemTypes] [/noFixedWork] [/projectFieldForWorkItemType:ProjectFieldName] [/skipUIChanges]

TfsAdmin ProjectServer /UnmapPlanFromTeamProject /collection:tpcUrl /enterpriseProject:EnterpriseProjectName /teamProject:TeamProjectName [/force]

參數

參數	描述
/collection:tpcUrl	指定 Team 專案集合的統一資源定位器 (URL)。您可以使用下列格式指定 URL：http://ServerName:Port/VirtualDirectoryName/CollectionName 如果您未指定使用虛擬目錄，則可以使用下列格式指定 URL： http://ServerName:Port/CollectionName
/enterpriseProject:EnterpriseProjectName	指定企業專案計劃的名稱。計劃必須儲存和發佈在 Project Server，而 PWA 的執行個體必須先註冊於儲存專案集合所在之 Team Foundation Server 的部署。
/teamProject:TeamProjectName	指定在專案集合中定義的 Team 專案的名稱。
/workItemTypes:ListofWorkItemTypes	以逗號分隔清單指定一個或多個工作項目類型的參考名稱。您只應該指定那些您要在 Project Professional 中追蹤其資料的工作項目的類型。例如，您可以將下列要支援 Agile 流程的工作項目類型指定為 "使用者劇本,工作" 或 "使用者劇本",工作 (逗號之後不要包含空格)。
/noFixedWork	指定不要針對在 Team Foundation 中對應至工作項目的工作，自動將 Project Professional 中的工作類型設定為固定工時。根據預設，在兩個伺服器產品之間進行整合的過程中，企業專案計劃中對應到 Team Foundation 工作項目的工作會將其工作類型設定為 [固定工時]。您可以使用這個選項覆寫這個行為。固定工作 (Fixed Work) 是您可在 Project 中使用的三種工作 (Task) 之一。如需詳細資訊，請參閱變更 Project 用來計算工作持續時間的工作類型 (英文)。
/projectFieldForWorkItemType: ProjectFieldName	指定用來顯示定義於 Team Foundation 之工作項目類型值的 Microsoft Project 欄位的名稱。您應該指定介於 pjTaskText1 和 pjTaskText30 之間的值。根據預設，這個值為 pjTaskText30。
/force	移除所有工作項目的所有的對應，這些工作項目是在 Team 專案中定義而目前連結至專案計劃。未對應的 Team 專案不能包含任何連結的工作項目。只有在您確定不再需要 Team 專案中的任何工作項目繼續參與資料同步處理時，才應該指定這個選項。
/skipUIChanges	指定不應該將工作項目表單中的 [Project Server] 索引標籤變更為您所指定的類型。如果您已經為受影響的型別自訂 [Project Server] 索引標籤，則應該包含這個旗標。
/? 或 help	顯示命令的相關資訊。

回到頁首

備註

執行命令時會顯示訊息，指出正在執行的動作以及動作正在處理的物件。例如，下列訊息表示正在對應企業專案計劃：

Mapping enterprise project EntProjA . . . Done.

命令完成後，會出現另一個訊息。例如，下列訊息表示企業專案計劃已經對應至 Team 專案：

Mapping enterprise project EntProjA to team project MyTeamProj . . . Done.

除了將企業專案計劃與 Team 專案相關聯，/MapPlantoTeamProject 選項還會將 [Project Server] 索引標籤加入至您指定的工作項目類型的工作項目表單。

如果嘗試將企業專案對應到沒有欄位對應的 Team 專案，則會有訊息表示需要對應，並且不再執行其他作業。如需詳細資訊，請參閱自訂 Project Server 與 Team Foundation Server 之間的欄位對應。

如果您移除企業專案和 Team 專案 (後者沒有其他企業專案對應) 之間的對應，則會從您取消對應之 Team 專案中的所有工作項目類型的表單移除 [Project Server] 索引標籤。

您必須先移除企業專案計劃的工作與 Team Foundation 的工作項目之間關聯，才能取消對應 Team 專案。您刪除企業專案計劃中的工作、發佈計劃，並等待同步處理完成，即可移除此關聯。或者，您可以使用 /force 旗標來移除專案工作與工作項目間的關聯。

提示
在刪除作業之前，您可能會想要複製至另一個計劃記錄您刪除的工作。

回到頁首

範例

除非另行指定，下列的值會套用在每個範例：

• PWA 執行個體的 URL：http://MyPWAServer/MyPWAInstance/

• Team Foundation Server 的 URL：http://AdventureWorksServer:8080/tfs/

• Team 專案集合的 URL：http://AdventureWorksServer:8080/tfs/DefaultCollection

列出已對應的企業專案

下面範例會列出在 AdventureWorksServer 上對應至 Collection0 中的 Team 專案的企業專案。

TfsAdmin ProjectServer /GetMappedProjects /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

將企業專案對應至 Team 專案

下列範例會將 MyEnterpriseProjA 對應 MyTeamProjB 在 AdventureWorksServer 中 DefaultCollection 並指定使用者劇本和工作將參與同步處理。

TfsAdmin ProjectServer /MapPlanToTeamProject /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ enterpriseProject:MyEnterpriseProjA /teamProject:MyTeamProjB /workItemTypes:"User Story, Task"

移除企業專案到 Team 專案的對應

下列範例會移除 MyEnterpriseProjA 的關聯至 AdventureWorksServer 上的 MyTeamProjB 在 DefaultCollection。

TfsAdmin ProjectServer /UnmapPlanFromTeamProject /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection/ enterpriseProject:MyEnterpriseProjA /teamProject:MyTeamProjB

回到頁首

請參閱

工作

設定 Team Foundation Server 和 Project Server 的整合

概念

使用 TfsAdmin ProjectServer 管理 Project Server 整合