TFSDeleteProject：刪除 Team 專案

專案不再需要時，您可以使用 TFSDeleteProject 移除 Team Foundation Server 中的 Team 專案。 此外，建立 Team 專案失敗後，如果有仍未刪除的元件，您可以使用 TFSDeleteProject 移除它們。

重要事項
TFSDeleteProject 會永久終結 Team 專案，且之後便無法復原。 使用 TFSDeleteProject 之前，請備份所有重要的專案資料。

在任何執行 Team 總管 的用戶端電腦上，您可以在 Drive:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE 中找到 TFSDeleteProject 命令列工具。 

注意事項
即使您使用系統管理權限登入，還是必須開啟較高權限的命令提示字元視窗，在執行 Windows Server 2008 的伺服器上執行此功能。 若要開啟更高權限的 [命令提示字元] 視窗，請按一下 [開始]，並以滑鼠右鍵按一下 [命令提示字元]，然後按一下 [以系統管理員身分執行]。 如需詳細資訊，請參閱 Microsoft 網站：使用者帳戶控制。

必要的使用權限

您必須是 [Team Foundation Administrators] 安全性群組或 [Project Administrators] 安全性群組的成員，才能使用 TFSDeleteProject 命令。 如需詳細資訊，請參閱Team Foundation Server 使用權限和Team Foundation Server 預設群組、使用權限和角色。

TFSDeleteproject [/q] [/force] [/excludewss] /collection:URL TeamProjectName

參數

選項	描述
/q	選擇項。 使用無訊息模式。 不提示使用者進行確認。
/force	選擇項。 指定即使某些元件不能刪除，刪除程序仍應該繼續。
/excludewss	選擇項。 指定不刪除與 Team 專案相關的 SharePoint 網站。 指定這個選項以維護現有的網站，讓其他 Team 專案可以繼續使用它。
/collection:URL	必要項。 指定 Team 專案集合的 URI。 URI 的格式必須如下：http://ServerName:Port/VirtualDirectoryName/CollectionName 如果您未指定使用虛擬目錄，則必須使用下列 URI 格式： http: / /ServerName:Port / CollectionName。
TeamProjectName	必要項。 專案的名稱。 如果名稱中包含空格，請用引號括住。

備註

當您建立 Team 專案時，Team Foundation Server 會在裝載 Team Foundation Server 的伺服器上建立資料物件，並且可能會在裝載 SharePoint 產品 的伺服器及裝載 SQL Server 報表服務的伺服器上建立資料物件。 當您移除 Team 專案時，會自動從 SQL Server 報表服務移除報表。

當您移除 Team 專案時，您可以選擇是否要移除為了支援 SharePoint 網站所建立的物件。 但是，錯誤可以防止 Team Foundation Server 建立或刪除所有物件。 為疑難排解這些問題，下列章節提供背景資訊、其他資源的連結，以及協助您判斷問題原因、修正問題的詳細步驟，同時亦提供視需要刪除執行 TFSDeleteProject 後仍保留之資料物件的步驟。

• TFSDeleteProject 處理序

• 可能仍未刪除的資料

• 確認刪除 Team 專案元件

• 移除刪除部分專案後剩餘的元件

• 增加逾時期間

TFSDeleteProject 處理序

當您使用 TFSDeleteProject 命令列工具時，它會先刪除專案資料，再刪除專案網站。

階段 1: TFSDeleteProject 刪除專案資料

在第一階段中，TFSDeleteProject 會自動執行下列步驟，以移除 Team 專案資料：

1. TFSDeleteProject 會建立所有待刪除元件的清查。 這包括整合於 測試管理員、Team Foundation Build 和 Team Foundation 版本控制 的元件。

2. TFSDeleteProject 會刪除在 Team 總管 中顯示專案節點的元件。

3. TFSDeleteProject 會將版本控制資訊標記為刪除，但不會立即刪除此項資訊。 這些資訊包括指定專案中的所有版本控制項分支，但不包含專案以外的其他分支。

   • 如果父分支和子分支都在專案中，TFSDeleteProject 會標記刪除兩者。

   • 如果父分支和子分支在不同的專案中，TFSDeleteProject 只會標記指定的分支。

   • 如果另一個專案是指定專案的分支，TFSDeleteProject 只會標記指定的專案。 刪除指定的專案時，分支專案會失去關聯。

4. TFSDeleteProject 會立即刪除組建資料，包括資訊和核心資料、組建定義、組建代理程式，以及與 Team 專案相關的測試結果。 此工具不會刪除組建置放位置。 建立使用同一個組建置放位置的 Team 專案之前，您不需要刪除舊 Team 專案的組建置放位置。

   如果指定的專案包含大量的組建資料，可能會無法在逾時期間內完成刪除。 若要解決這個問題，請參閱 增加逾時期間，然後再執行一次 TFSDeleteProject。

5. TFSDeleteProject 會立即刪除屬於特定專案的工作項目和工作項目欄位，並且刪除所有非共用的中繼資料。

   如果指定的專案包含大量的工作項目資料，可能會無法在逾時期間內完成刪除。 若要解決這個問題，請參閱增加逾時期間，然後再執行一次 TFSDeleteProject。

階段 2: TFSDeleteProject 刪除專案網站

在第二個階段中，TFSDeleteProject 會刪除下列資料：

重要事項
這些步驟可能需要很長的時間才能完成，在這段期間內，可能會降低伺服器效能。

• TFSDeleteProject 會使用報表服務 API 刪除裝載報表服務之伺服器上的報表。

• TFSDeleteProject 會從裝載 SharePoint 產品 的伺服器刪除專案入口網站。 如果專案擁有站台，而命令列中未排除站台刪除時，才會發生這個步驟。 (請考慮多個專案可能指向單一站台，但其中只有一個可以是擁有者，其中報表/儀表板預設會使用這個專案)。

  注意事項
  刪除 Team 專案之前，您可以確認入口網站設定，確認報表服務和 SharePoint 產品 使用正確的專案 URL。 如需詳細資訊，請參閱加入 Team 專案入口網站。

如果 TFSDeleteProject 順利刪除所有上述的資料項目，則會傳回 完成 訊息。 若要確認此結果，請參閱確認已刪除 Team 專案元件。

如果不移除一或多個元件，即使無法刪除所有資料項目，您仍然可以使用 /force 選項繼續刪除作業，以重新執行 TFSProjectDelete。 使用此選項 TFSDeleteProject 時，會略過不能刪除的元件、傳回錯誤訊息、刪除下一個元件，並且將 Team 專案的中繼資料及安全性設定保持不變。

可能仍未刪除的資料

TFSDeleteProject 順利完成後，下列資料可能會保留在部署中：

• Cube 中的 Team 專案資料。 Team 專案資料仍會保留在 Cube 中，直到此 Cube 重建為止，此時倉儲控制器服務會移除所有已從 Team Foundation 資料庫中刪除的歷史建置資料。

• 建置置放檔案和資料夾。 建置二進位、建置記錄檔，以及包含測試結果的記錄檔都會在建置程序期間發行。 這些檔案的位置並不會被刪除。 如果要移除這些檔案，必須手動移除。

• 共用的工作項目追蹤中繼資料。 TFSDeleteProject 不會刪除 Team 專案公用之工作項目追蹤的任何中繼資料。

• 包含共用程式碼的版本控制擱置集。 如果多個 Team 專案的擱置集中含有程式碼，不會刪除版本控制擱置集。

確認專案刪除作業

您可以確認 Team 專案節點已不再出現於 Team 總管 中，而且其專案入口網站及報告資料夾已不存在，藉以確認專案定義成功與否。

確認已順利刪除 Team 專案

1. 開啟 Team 總管 並確認專案不會顯示為專案節點。

2. 開啟 Internet Explorer，然後輸入專案入口網站的 URL。 確認該網站不再存在。

3. 在 Internet Explorer 的 [網址] 方塊中，使用下列其中一種 URL 格式輸入報表服務網站的 URL：

   • http://ReportingServices/Reports

   • **http://ReportingServices/Reports_**TFSInstance

4. 按一下 [報表管理員] 中的 [顯示詳細資料]。

5. 確認已刪除之 Team 專案的資料夾不會再出現。 按一下根資料夾 TfsReports，然後按一下根據 Team 專案集合命名的資料夾。 資料夾的名稱不可再是已刪除專案的名稱。

6. 如果報告或網站仍存在，請參閱下一個程序。

移除刪除部分專案後剩餘的元件

如果刪除 Team 專案後仍保留專案入口網站的網站和報告資料夾，請以手動方式移除網站和資料夾。

手動移除報告和已刪除 Team 專案的專案入口網站

1. 登入裝載您刪除之 Team 專案的報表服務的伺服器。

2. 開啟 Internet Explorer，並在 [網址] 方塊中使用下列其中一種 URL 格式輸入報表服務網站的 URL：

   • https://localhost/Reports

   • **https://localhost/Reports_**TFSInstance

3. 按一下 [報表管理員] 中的 [顯示詳細資料]。

4. 按一下根資料夾 TfsReports，然後按一下根據 Team 專案集合命名的資料夾。

5. 選取已刪除之 Team 專案的核取方塊。

6. 按一下 [刪除]。

7. 按一下 [確定]，確認您要刪除 Team 專案的報告資料夾。

8. 若要移除已刪除之 Team 專案的專案入口網站，請參閱 Microsoft 網站上的下列頁面： HOW TO：建立、編輯與刪除 Windows SharePoint 服務網站 (英文)。

增加逾時期間

預設情況下，TFSDeleteProject 命令發出以刪除元件的每個 Web 服務呼叫都必須在 10 分鐘內完成。 如果有六個呼叫，處理序最多可能需要一個小時。 如果要刪除與大量資料相關的 Team 專案，可以暫時增加這個逾時期間。

注意事項
當您提高逾時期間時，變更會影響所有的 Web 服務呼叫。 通常會將逾時時間保持在 10 秒內，避免 Web 服務降低伺服器的效能，也防止使用者長時間無法使用使用者介面。 因此，成功刪除專案之後，您應該將逾時期間變更回為 10 分鐘。

必要的使用權限

您必須是應用程式層伺服器的 Windows 系統管理員，才能完成這些程序。

重要事項
不當修改您電腦的登錄可能造成電腦不穩定。 如果您對登錄並不熟悉，則您不應該增加或移除登錄，或以任何方式進行修改。

增加 TFSDeleteProject 命令的逾時期間

1. 登入應用程式層伺服器。

2. 依序按 [開始] 和 [執行]、輸入 regedit，然後按一下 [確定]。

3. 在瀏覽器窗格中展開 HKEY_ LOCAL_MACHINE：

   • 如果伺服器執行 32 位元作業系統，請展開：HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\10.0\TeamFoundation\RequestSettings。

   • 如果伺服器執行 64 位元作業系統，請展開：HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432\Microsoft\VisualStudio\10.0\TeamFoundation\RequestSettings。

4. 如果 TeamFoundation\RequestSettings 機碼不存在，請依照下列步驟執行來建立它：

   1. 以滑鼠右鍵按一下 [TeamFoundation]、指向 [新增]，然後按一下 [索引鍵]。

   2. 將金鑰命名為 RequestSettings。

   3. 以滑鼠右鍵按一下 [RequestSettings]、指向 [新增]，然後按一下 [DWORD 値]。

   4. 將新值命名為 DefaultTimeout。

5. 以滑鼠右鍵按一下 [DefaultTimeout]，再選擇 [修改]。

6. 在 [數値資料] 中輸入逾時期間 (以毫秒為單位)，然後按一下 [十進位]。

   例如，若要將逾時期間增加為 30 分鐘，請輸入 1800000。 若要將逾時期間變更回 10 分鐘，請輸入 600000。

7. 按一下 [確定]。

8. 按一下 [檔案] 功能表上的 [結束]。

範例

下列命令會移除與 Team 專案 StoreFront 相關的所有元件 (這些元件位於專案集合 Collection1 中的 Team Foundation Server AdventureWorks1 伺服器，以及來自 Team 總管)。

TFSDeleteProject /force /collection:http://AdventureWorks1:8080/Collection1 StoreFront

請參閱

工作

在 Team Foundation Server 中連接和存取 Team 專案

建立 Team 專案

其他資源

管理使用權限

設定資源以支援 Team 專案

使用 Team Foundation Server 命令列工具