在 Azure DevOps 中重新命名專案

  • 發行項

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

在 Azure DevOps 中重新命名專案會更新版本控制路徑、工作專案、查詢和其他專案成品中的項目名稱。 您可以多次重新命名單一專案，並使用舊名稱。 重新命名后，小組成員可能需要執行一些動作。

警告

GitHub Copilot：重新命名專案時，如果用戶計數小於 1,000，Azure DevOps 會透過電子郵件通知所有項目成員。 對於超過 1,000 位使用者的專案，只有 Project Collection 管理員 istrators 會收到這些通知。

工作負載身分識別同盟：重新命名專案將會中斷 Azure Resource Manager 服務連線中的工作負載身分識別同盟主體。

必要條件

  • 您必須是 Project 管理員 istrators 群組的成員，或將專案層級重新命名小組專案許可權設定為 [允許]。 如需詳細資訊，請參閱 變更專案層級許可權。
  • 您必須是 Project 管理員 istrators 群組的成員，或將專案層級重新命名小組專案許可權設定為 [允許]。 如需詳細資訊，請參閱 變更專案層級許可權。

重新命名專案

  1. 登入您的組織 （https://dev.azure.com/{Your_Organization}），然後開啟您要重新命名的專案。

  2. 選取 [項目設定>概觀]，然後輸入新名稱，然後選取 [儲存]。

    Screenshot showing new name entry and highlighted save button.

  3. 若要確認重新命名，請輸入新的項目名稱，核取 [我瞭解重新命名此項目的後果] 旁的方塊，然後選取 [ 儲存]。

    Screenshot showing new name confirmation screen with save button.

重新命名的結果

重新命名作業之後會發生下列結果。

  • Azure DevOps 會重新命名專案。

  • 如果成員少於 1,000 個成員，則所有專案成員都會收到名稱變更的電子郵件通知。

  • URL 會繼續為新的小組名稱和舊的小組名稱運作。 這項功能旨在避免中斷連結。

  • 如果 URL 中的項目是組織中的有效項目，我們會顯示提供的工作專案標識碼。 下列範例顯示名為 「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 錯誤

  • 工作專案標識碼在組織中是唯一的，因此連結不會過期。

  • 舊專案名稱可以再次使用。

使用已重新命名專案所需的用戶動作

小組內的每個用戶都必須 重新啟動其用戶端 ，並根據所使用的功能執行下列一些動作：

重新啟動用戶端

開啟的用戶端會保留記憶體中所有專案名稱的快取，但重新命名項目之後，此快取不會自動清除。 若要清除快取，請重新啟動您的用戶端，使其填入新的項目名稱。 如果您未重新啟動用戶端，則使用快取專案名稱的作業會失敗，但 找不到 專案例外狀況。

針對下列用戶端，請將您的工作儲存在每一個中，然後重新啟動：

更新 Git 遠端

如果您的專案使用 Git，則必須更新重新命名專案中每個存放庫的遠程參考。 這些更新是必要的，因為遠端存放庫 URL 包含專案和存放庫名稱。 Git 會使用遠程參考來擷取和推送本機存放庫與儲存在伺服器上的遠端版本之間的變更。 小組的每個成員都必須更新其本機 Git 存放庫，才能繼續從其開發機器連線。

如需詳細資訊，請參閱 更新您開發電腦上的 Git 遠端。

更新 TFVC 伺服器工作區

如果您的專案搭配 伺服器工作區使用 TFVC，則必須以新的專案名稱更新這些工作區。 若為 Visual Studio 用戶端，請執行取得或簽入，然後更正工作區對應以使用新的項目名稱。

Screenshot of source control explorer, showing get latest version selection.

如需詳細資訊，請參閱 重新命名命令 （TFVC） 。

更新 TFVC 本機工作區

如果您的小組使用 TFVC 搭配 本機工作區，則必須以新的專案名稱更新這些工作區。 若為Visual Studio，請執行取得或簽入，並更正工作區對應以使用新的項目名稱。

建議您盡可能將用戶端更新為最新的更新或版本。 對於所有其他支援的 Visual Studio 版本，您必須建立對應至新專案名稱的新本機工作區。

本機工作區在本機進行管理，而不是在伺服器上管理。 沒有更新重新命名邏輯的較舊客戶端無法將本機工作區更新為新的項目名稱。

常見問題集 (FAQ)

問：為什麼我的嘗試重複使用專案名稱因為現有的工作空間而失敗？

答：如果仍有工作區對應尋址，則無法重複使用項目名稱。 此函式有助於避免將工作區對應至兩個專案的模棱兩可案例。 請連絡具有這些對應的使用者，並加以刪除或 更新以 使用新名稱。

如果已不再提供包含工作區的用戶計算機，您可以從 Visual Studio 的開發人員命令提示字元執行下列命令來刪除工作區： tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner]

問：重新命名專案如何影響我的瀏覽器瀏覽體驗？

答：重新命名項目之後，任何開啟專案的瀏覽器都可能會遇到一些錯誤。 這些錯誤是由於瀏覽器保留的快取，其中包括舊的項目名稱。 重新整理，讓這些錯誤消失，因為快取會重新填入新的項目名稱。

問：專案中的其他成品是否重新命名？

答：是，所有共用相同名稱的成品都會隨著專案一起重新命名。 唯一的例外狀況是預設小組和存放庫。 這些成品的重新命名會盡最大努力執行。 例如，如果專案 Foo 已重新命名為 Bar，如果專案中已有名為 Bar 的小組，則預設小組 Foo 將不會重新命名。

問：為什麼無法在重新命名之後開啟儲存至磁碟的查詢？

答：如果您使用 Visual Studio 2010，而且有查詢儲存至磁碟，則無法在重新命名項目之後加以開啟。 您可以使用 Visual Studio 2012 或更新版本來開啟它們。