活动
删除项目
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
如果项目已过时,可以在 Azure DevOps 中将其从组织或集合中删除 。 同样,如果要从本地 Azure DevOps Server 迁移到 Azure DevOps Services,则可能需要删除项目。 删除项目还可以通过将项目限制为仅那些当前正在使用的项目来增强导航。
注意
类别 | 要求 |
---|---|
权限 | - 项目集合管理员组的成员。 组织所有者自动是此组的成员。 - 将删除团队项目权限设置为允许。 有关详细信息,请参阅查看项目级权限。 |
可选 | 如果要访问项目数据而不还原项目数据,在删除项目之前保存项目数据。 |
使用以下过程保存用户最关心的数据,例如源代码、生成数据和工作项。 此过程是可选的,在删除项目之前,可能需要考虑一些事项。
源代码和自定义生成模板: 将文件下载为 zip 文件。
选择存储库、文件或文件夹,然后选择“下载为 Zip”。 或者,选择“下载”
以下载当前所选文件夹中的所有文件或当前选定的文件。
此过程不会保存任何更改历史记录或指向其他项目的链接。 如果使用 Git, 请克隆存储库 以保留完整的项目历史记录和所有分支。
生成数据:若要在删除生成文件夹中保存日志和数据,请参阅 “查看生成结果”。
工作项跟踪数据:创建工作项查询并使用 Excel 将其打开。 保存 Excel 电子表格。
此过程不会保存指向其他项目的任何附件、更改历史记录或链接。
有关详细信息,请参阅我们的 数据保护概述。
使用 Web 浏览器执行软删除。 28 天后,如果未在该时间内还原,项目将永久删除。
(
https://dev.azure.com/{yourorganization}
) 登录到组织。选择
组织设置。
选择“项目”,选中要删除的一个或多个项目,然后选择“删除”。
输入项目名称确认删除,然后在弹出屏幕中选择“ 删除 ”。
项目被删除,最多可以还原 28 天。 已删除的项目将从项目列表中删除。
如果无意中删除 Azure DevOps 中的项目,可以在删除项目后的 28 天内还原该项目。
(
https://dev.azure.com/{yourorganization}
) 登录到组织。选择
组织设置。
选择“ 概述”,然后向下滚动到“最近删除的项目”。
突出显示要还原的项目,然后选择“ 还原”。
登录到实例(
http://{ServerName:8080/tfs/}/{CollectionName}
)。选择
“管理员设置”。
选择“项目”,然后向下滚动到最近删除的项目。
突出显示要还原的项目,然后选择“ 还原”。
备注
UI 不支持还原 Azure DevOps Server 2019 的团队项目。 使用以下 REST API 或 PowerShell 方法还原已删除的团队项目。 有关详细信息,请参阅 Projects-Update REST API。
警告
若要还原已使用的名称的项目,必须先重命名项目,然后才能还原该项目。 若要重命名项目,请在请求正文中输入以下文本: "name":"new name"
打开浏览器窗口并输入使用以下格式的 URL:
'http://ServerName:8080/tfs/DefaultCollection/ProjectName'
例如,若要连接到名为 FabrikamPrime 的服务器,请输入:“”。http://FabrikamPrime:8080/tfs/
默认端口为 8080。 如果未使用默认值,请指定服务器的端口号和目录。
使用以下请求获取已删除项目的列表:
GET http://ServerName:8080/tfs/DefaultCollection/_apis/projects?stateFilter= deleted&api-version=5.0-preview.3
使用以下请求还原已删除的项目:
PATCH http://ServerName:8080/tfs/DefaultCollection/_apis/projects/{projectId}? api-version=5.0-preview.3
请求正文
{ "state" : "wellFormed" }
执行以下 PowerShell 脚本以获取已删除项目的列表,并确保更新
$collectionUrl
。$collectionUrl = "https://localhost/defaultcollection" (irm -Uri "$collectionUrl/_apis/projects?stateFilter= deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
使用以下脚本还原项目。 请务必更新
$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 小时内删除工作项。
答:在永久删除项目之前等待 28 天。
其他资源
培训
文档
-
将项目更改为公共项目或专用项目 - Azure DevOps Services Public and Private Projects
更改项目可见性(专用或公共),并了解公共项目的访问级别和功能限制。
-
查找 Azure DevOps 平台和版本 - Azure DevOps
了解如何查找正在使用的 Azure DevOps 平台和版本。
-
如何将用户或组添加到团队,或向项目添加成员或组。