刪除專案

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019

如果專案過時，您可以從 Azure DevOps 中的組織或集合中刪除該專案 。 同樣地，如果您要從內部部署 Azure DevOps Server 移轉至 Azure DevOps Services，可能需要刪除專案。 移除專案也可以藉由將專案限制為目前使用中的專案，來增強流覽。

警告

從入口網站刪除的專案會虛刪除，並在 28 天內未還原時永久移除。 不過，從內部部署 Azure DevOps 管理員istration Console 中刪除的專案會進行硬式刪除，且無法還原。 如需還原詳細資料，請參閱 還原專案 。 若要在不還原的情況下從已刪除的專案存取資料， 請儲存專案資料 。

必要條件

• 您必須是 Project Collection 管理員istrators 群組 的成員 。 組織擁有者會自動成為此群組的成員。
• 您必須將 [ 刪除小組專案 ] 許可權設定為 [ 允許 ]。 如需詳細資訊，請參閱 檢視專案層級許可權 。
• （選擇性） 如果您想要存取專案資料而不還原專案， 請先儲存專案資料，再刪除專案。

儲存專案資料

使用下列程式來儲存使用者最關心的資料，例如原始程式碼、建置資料和工作專案。 此程式是選擇性的，而且您可能會在刪除專案之前考慮的專案。

• 原始程式碼和自訂群組建範本： 將您的檔案下載為 zip 檔案。 針對存放庫、檔案或資料夾選取 ， 然後選取 [ 下載為 Zip ]。 或者，選取 [ 下載 ] 以下載目前選取資料夾中的所有檔案，或目前選取的檔案。

  

  此程式不會儲存任何變更歷程記錄或其他成品的連結。 如果您使用 Git， 請複製存放庫 以保留完整的專案歷程記錄和所有分支。

• 建置資料 ：若要在卸載組建資料夾中儲存記錄和資料，請參閱 檢視建置結果 。

• 工作專案追蹤資料： 建立工作專案查詢，並使用 Excel 加以開啟 。 儲存 Excel 試算表。

  此程式不會儲存任何附件、變更歷程記錄或其他成品的連結。

如需詳細資訊，請參閱我們的 資料保護概觀 。

刪除專案

瀏覽器

使用網頁瀏覽器執行虛刪除。 28 天后，如果未在該時間內還原專案，則會永久刪除專案。

1. 登入您的組織 (https://dev.azure.com/{yourorganization})。

2. 選取組織設定。

   

3. 選取 [專案 ]，檢查要刪除的一或多個專案，然後選取 [ 刪除 ]。

   

4. 輸入專案名稱以確認刪除，然後在快顯畫面中選取 [ 刪除 ]。

   

您的專案已刪除，且最多可以還原 28 天。 已刪除的專案會從專案清單中移除。

管理員istration 主控台

內部部署 Azure DevOps Server 僅支援 管理員istration 主控台。

Azure DevOps CLI

您可以使用 az devops project delete 命令來刪除 小組專案 。 若要開始使用，請參閱 開始使用 Azure DevOps CLI 。

az devops project delete --id
                         [--org]
                         [--yes] 

參數

• id ：必要。 您要刪除之專案的識別碼。 若要判斷專案的識別碼，請使用 az devops project list 命令。
• 組織：Azure DevOps 組織 URL。 您可以使用 來設定預設組織 az devops configure -d organization=ORG_URL 。 如果未設定為預設或使用 git config 來挑選，則為必要項。 範例：--org https://dev.azure.com/MyOrganizationName/。
• 是 ：不要提示確認。

範例

下列命令會刪除具有指定識別碼的 Team 專案，而不會提示您進行確認。

az devops project delete --id 9a61d475-b1a7-4da7-b9db-80df15ac985c --yes

還原已刪除的專案

如果您不小心刪除 Azure DevOps 中的專案，您可以在刪除專案的 28 天內加以還原。

1. 登入您的組織 (https://dev.azure.com/{yourorganization})。

2. 選取組織設定。

   

3. 選取 [ 概觀 ]，然後向下捲動至「最近刪除的專案」。

   

4. 反白顯示您要還原的專案，然後選取 [ 還原 ]。

   

使用 REST API 還原專案

警告

若要還原已取得名稱的專案，您必須先重新命名專案，才能還原專案。 若要重新命名專案，請在要求本文中輸入下列文字： "name":"new name"

1. 開啟瀏覽器視窗，然後輸入使用下列表單的 URL：

   'http://ServerName:8080/tfs/DefaultCollection/ProjectName'

   例如，若要連線到名為 FabrikamPrime 的伺服器，請輸入： ' http://FabrikamPrime:8080/tfs/ '。

   預設埠為 8080。 如果未使用預設值，請指定伺服器的埠號碼和目錄。

2. 使用下列要求取得已刪除的專案清單：

   GET http://ServerName:8080/tfs/DefaultCollection/_apis/projects?stateFilter=
   deleted&api-version=5.0-preview.3
   

3. 使用下列要求還原已刪除的專案：

   PATCH http://ServerName:8080/tfs/DefaultCollection/_apis/projects/{projectId}?
   api-version=5.0-preview.3
   

   要求本文

   {
    "state" : "wellFormed"
   }
   

使用 PowerShell 還原專案

1. 執行下列 PowerShell 腳本以取得已刪除的專案清單，並確定更新 $collectionUrl 。

   $collectionUrl = "https://localhost/defaultcollection"
   (irm -Uri "$collectionUrl/_apis/projects?stateFilter=
   deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
   

   如下所示的螢幕擷取畫面隨即出現：

2. 使用下列腳本還原專案。 請務必更新 $collectionUrl 和 $projectName 。

   $collectionUrl = "https://localhost/defaultcollection"
   $projectName = 'Project1'
   $project = (irm -Uri "$collectionUrl/_apis/projects?stateFilter=
   deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
    | where {$_.name -eq $projectName}
   irm -Uri ($project.url + "?api-version=5.0-preview.3") 
   -UseDefaultCredentials -Method PATCH -Body '{"state":"wellFormed"}'
    -ContentType 'application/json'
   

您的專案和相關聯的資料會還原。

常見問題集

請參閱下列有關刪除 Azure DevOps 中專案的常見問題。

問：刪除一個專案之後，為什麼剩餘專案中的工作專案仍有已刪除專案工作專案的連結？

答：刪除專案後 24 小時內刪除工作專案。

問：我刪除了 Azure DevOps 中的專案，但在 Visual Studio Team Explorer 中，它仍然存在，我該怎麼做？

答：在永久刪除專案之前等候 28 天。

相關文章

• 建立專案
• 還原專案
• 使用 REST API 刪除專案
• TFSDeleteProject 命令列工具