删除项目

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

如果项目已过时，可以在 Azure DevOps 中将其从组织或集合中删除 。 同样，如果要从本地 Azure DevOps Server 迁移到 Azure DevOps Services，则可能需要删除项目。 删除项目还可以通过将项目限制为仅那些当前正在使用的项目来增强导航。

注意

• 如果未在 28 天内还原，Web 门户中的软删除项目会永久删除。
• 在极少数情况下，由于后端重试以及需要从多个源中删除数据，删除过程可能需要长达 70 天。
• 无法从本地 Azure DevOps 管理控制台还原硬删除的项目。 有关详细信息，请参阅 “还原项目 ”和 “保存项目数据”。

先决条件

• 权限：
  • 必须是项目集合管理员组的成员。 组织所有者自动是此组的成员。
  • 将“删除团队项目”权限设置为“允许”。 有关详细信息，请参阅查看项目级权限。
• 可选：如果要在不还原项目数据的情况下访问项目数据，请先保存项目数据，然后再删除项目数据。

保存项目数据

使用以下过程保存用户最关心的数据，例如源代码、生成数据和工作项。 此过程是可选的，在删除项目之前，可能需要考虑一些事项。

• 源代码和自定义生成模板： 将文件下载为 zip 文件。 选择存储库、文件或文件夹，然后选择“下载为 Zip”。 或者，选择“下载”以下载当前所选文件夹中的所有文件或当前选定的文件。

  

  此过程不会保存任何更改历史记录或指向其他项目的链接。 如果使用 Git， 请克隆存储库 以保留完整的项目历史记录和所有分支。

• 生成数据：若要在删除生成文件夹中保存日志和数据，请参阅 “查看生成结果”。

• 工作项跟踪数据：创建工作项查询并使用 Excel 将其打开。 保存 Excel 电子表格。

  此过程不会保存指向其他项目的任何附件、更改历史记录或链接。

有关详细信息，请参阅我们的 数据保护概述。

删除项目

浏览器

使用 Web 浏览器执行软删除。 28 天后，如果未在该时间内还原，项目将永久删除。

1. (https://dev.azure.com/{yourorganization}) 登录到组织。

2. 选择 组织设置。

   

3. 选择“项目”，选中要删除的一个或多个项目，然后选择“删除”。

   

4. 输入项目名称确认删除，然后在弹出屏幕中选择“ 删除 ”。

   

项目被删除，最多可以还原 28 天。 已删除的项目将从项目列表中删除。

管理控制台

仅本地 Azure DevOps Server 支持管理控制台。

Azure DevOps CLI

可以使用 az devops project delete 命令删除团队项目。 要开始，请参阅 Azure DevOps CLI 入门。

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

参数

• id：必需。 要删除的项目的 ID。 若要确定项目的 ID，请使用 az devops project list 命令。
• org：Azure DevOps 组织 URL。 可以使用 配置默认组织 az devops configure -d organization=ORG_URL。 如果未配置为默认或使用 选取 git config，则为必需。 示例：--org https://dev.azure.com/MyOrganizationName/。
• 是：不提示确认。

示例

以下命令删除具有指定 ID 的团队项目，而无需提示确认。

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 团队资源管理器中，它仍然存在，我该怎么办？

答：在永久删除项目之前等待 28 天。

相关文章

• 创建项目
• 还原项目
• 使用 REST API 删除项目
• 使用 TFSDeleteProject 命令行工具