通过

在 Azure DevOps 中重命名项目

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

在 Azure DevOps 中重命名项目会更新版本控制路径、工作项、查询和其他项目工件中的项目名称。 可以多次重命名一个项目，并使用旧名称。 重命名项目后，团队成员可能需要执行一些操作。

警告

  • 重命名项目后，如果用户数小于 1000，Azure DevOps 会通过电子邮件通知所有项目成员。 如果是超过 1000 个用户的项目，则只有项目集合管理员才会收到这些通知。

  • 重命名项目会中断 Azure 资源管理器服务连接中的工作负荷身份联合主体。

先决条件

类别 要求
权限 项目管理员组的成员或在项目级将团队项目权限设置为允许。 有关详细信息，请参阅 更改项目级权限。

重命名项目

  1. 登录到你的项目 (https://dev.azure.com/{Your_Organization}/{Your_Project})。

  2. 选择项目设置>概述，然后输入新名称并选择“保存”。

    显示新名称输入和突出显示的“保存”按钮的屏幕截图。

  3. 要确认重命名，请输入新的项目名称，勾选“我了解重命名此项目的后果”旁边的框，然后选择“保存”。

    显示带有“保存”按钮的新名称确认屏幕的屏幕截图。

重命名结果

重命名操作后会出现以下结果。

  • Azure DevOps 重命名项目。

  • 如果成员少于 1,000 人，所有项目成员都会收到名称更改的电子邮件通知。

  • 该 URL 对新团队名称和旧团队名称都继续有效。 此功能旨在避免链接断裂。

  • 如果 URL 中的项目是组织中的有效项目，我们会显示提供的工作项 ID。 以下示例显示一个组织，其中包含名为“Example1”和“Example2”的项目。

    https://dev.azure.com/MyOrg/Example1/_workitems/edit/40/ - 显示工作项 40 https://dev.azure.com/MyOrg/Example2/_workitems/edit/40/ - 显示工作项 40 https://dev.azure.com/MyOrg/Potato/_workitems/edit/40/ - 显示 404 错误

  • 工作项 ID 在组织中是唯一的，因此链接不会过期。

  • 旧项目名称可以再次使用。

使用重命名项目所需的用户操作

团队中的每个用户必须重启其客户端，并根据他们使用的功能执行以下部分操作：

重启客户端

已打开的客户端在内存中保留所有项目名称的缓存，但重命名项目后，此缓存不会自动清除。 要清除缓存，请重启客户端，使其填充新的项目名称。 如果不重启客户端，使用缓存的项目名称的操作将失败，并出现“找不到项目”异常。

对于以下客户端，请在每个客户端中保存你的工作，然后重启：

更新 Git 远程库

如果你的项目使用 Git，则必须更新来自重命名项目的每个存储库的远程引用。 这些更新是必要的，因为远程存储库 URL 包含项目和存储库名称。 Git 使用远程引用来在本地存储库和服务器上存储的远程版本之间获取和推送更改。 团队的每个成员必须更新其本地 Git 存储库，以继续从其开发计算机进行连接。

有关详细信息，请参阅更新开发计算机上的 Git 远程库。

更新 TFVC 服务器工作区

如果项目将 TFVC 与服务器工作区一起使用，则这些工作区必须使用新的项目名称进行更新。 对于 Visual Studio 客户端，请执行获取或签入操作，更正工作区映射以使用新项目名称。

源代码管理资源管理器的屏幕截图，显示“获取最新版本”选项。

有关详细信息，请参阅重命名命令 (TFVC)。

更新 TFVC 本地工作区

如果你的团队将 TFVC 与本地工作区一起使用，则这些工作区需要使用新的项目名称进行更新。 对于 Visual Studio，请执行获取或签入操作，更正工作区映射以使用新的项目名称。

我们建议尽可能将客户端更新到最新更新或版本。 对于所有其他受支持的 Visual Studio 版本，必须创建映射到新项目名称的新本地工作区。

本地工作区在本地管理，而不是在服务器上。 没有更新的重命名逻辑的旧客户端无法将本地工作区更新为新的项目名称。

更新 OData 源

如果在 Power BI 中使用 OData 源，请更新源 URL 以使用新的项目名称。 更新源 URL 对于维护数据连接并避免报告错误至关重要。 有关详细信息，请参阅 使用 OData 查询的示例报告概述。

更新分析视图

如果使用旧项目名称创建自定义 Analytics 视图，则需要使用新名称更新视图。 有关详细信息，请参阅 Analytics 视图。

相关内容

常见问题 (FAQ)

问：为什么我尝试重复使用项目名称时，却因已存在的工作区而失败了呢？

答：如果仍有工作区映射指向项目名称，则不能重用该项目名称。 此功能有助于避免工作区可能映射到两个项目的歧义情况。 请联系具有这些映射的用户，删除或 更新这些映射以使用新名称。

如果包含工作区的用户计算机不再可用，则可以从 Visual Studio 的开发人员命令提示符运行以下命令来删除工作区：tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner]

问：重命名项目如何影响我的浏览器导航体验？

答：重命名项目后，任何打开该项目的浏览器可能会遇到一些错误。 这些错误是由于浏览器保存的缓存（包括旧项目名称）导致的。 刷新以消除这些错误，因为缓存将使用新的项目名称重新填充。

问：项目中的其他项目是否会被重命名？

答：是的，所有与项目名称相同的项目都会随项目一起重命名。 唯一的例外是默认团队和存储库。 对这些项目的重命名是尽力而为的。 例如，如果项目 Foo 重命名为 Bar，如果项目中已存在名为 Bar 的团队，则默认团队 Foo 不会被重命名。

问：为什么重命名后无法打开保存到磁盘的查询？

答：如果你使用 Visual Studio 2010 且将查询保存到磁盘，则重命名项目后无法打开它们。 你可以使用 Visual Studio 2012 或更高版本打开它们。

  • Last updated on