Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022
在 Azure DevOps 中重新命名專案，會更新版本控制路徑、工作項目、查詢和其他專案成品中的專案名稱。 您可以多次重新命名單一專案，還可以使用舊名稱。 當您重新命名項目之後，可能需要小組成員執行某些動作。
警告
重新命名專案時，如果使用者計數小於 1,000，Azure DevOps 會透過電子郵件通知所有專案成員。 對於超過 1,000 位使用者的專案，只有專案集合管理員會收到這些通知。
重新命名專案會破壞 Azure Resource Manager 服務連線中的工作負載身分識別聯盟對象。
必要條件
| 類別 | 要求 |
|---|---|
| 權限 | 專案管理員 群組或專案層級 將小組專案重新命名 許可權設定為 Allow的成員。 如需詳細資訊，請參閱＜變更專案層級權限＞(機器翻譯)。 |
重新命名專案
登入您的專案 （
https://dev.azure.com/{Your_Organization}/{Your_Project}）。選取 [項目設定>概觀]，然後輸入新名稱，然後選取 [儲存]。
![顯示新名稱專案並醒目提示 [儲存] 按鈕的螢幕快照。](media/rename-project/rename-project-azure-devops.png?view=azure-devops)
若要確認重新命名，請輸入新的項目名稱，核取 [我瞭解重新命名此項目的後果] 旁的方塊，然後選取 [ 儲存]。
![顯示 [新增名稱確認] 畫面的螢幕快照，其中含有 [儲存] 按鈕。](media/rename-project/rename-project-confirm.png?view=azure-devops)
重新命名的結果
重新命名作業之後會發生下列結果。
Azure DevOps 會重新命名專案。
如果成員少於 1,000 個成員，則所有專案成員都會收到名稱變更的電子郵件通知。
URL 仍然可以同時適用於新團隊名稱和舊團隊名稱。 這項功能旨在避免中斷連結。
如果 URL 中的項目是組織中的有效項目，我們會顯示提供的工作專案標識碼。 下列範例顯示名為 「Example1」 和 「Example2」 項目的組織。
https://dev.azure.com/MyOrg/Example1/_workitems/edit/40/- 顯示工作專案 40https://dev.azure.com/MyOrg/Example2/_workitems/edit/40/- 顯示工作專案 40https://dev.azure.com/MyOrg/Potato/_workitems/edit/40/- 顯示 404 錯誤工作專案標識碼在組織中是唯一的，因此連結不會過期。
舊專案名稱可以再次使用。
使用已重新命名專案所需的用戶操作
小組內的每個用戶都必須 重新啟動其用戶端 ，並根據所使用的功能執行下列一些動作：
重新啟動用戶端
開啟的用戶端會保留記憶體中所有專案名稱的快取，但重新命名項目之後，此快取不會自動清除。 若要清除快取，請重新啟動您的用戶端，使其填入新的項目名稱。 如果您未重新啟動用戶端，則使用快取專案名稱的作業會失敗，並出現專案未找到例外狀況。
針對下列用戶端，請將您的工作儲存在每一個中，然後重新啟動：
- Visual Studio 小組總管
- Microsoft Excel，如果您的小組使用 Azure DevOps Office Integration 2019
更新 Git 遠端
如果您的專案使用 Git，則必須更新重新命名專案中每個存放庫的遠程參考。 這些更新是必要的，因為遠端存放庫 URL 包含專案和存放庫名稱。 Git 會使用遠程參考來擷取和推送本機存放庫與儲存在伺服器上的遠端版本之間的變更。 小組的每個成員都必須更新其本機 Git 存放庫，才能繼續從其開發機器連線。
如需詳細資訊，請參閱 更新您開發電腦上的 Git 遠端。
更新 TFVC 伺服器工作區
如果您的專案搭配 伺服器工作區使用 TFVC，則必須以新的專案名稱更新這些工作區。 若為 Visual Studio 用戶端，請執行進行取得或簽入操作，之後工作區對應會更正為使用新的專案名稱。
如需詳細資訊，請參閱 重新命名命令 （TFVC） 。
更新 TFVC 本機工作區
如果您的小組使用 TFVC 搭配 本機工作區，則必須以新的專案名稱更新這些工作區。 若為Visual Studio，請執行取得或簽入，並更正工作區對應以使用新的項目名稱。
建議您盡可能將用戶端更新為最新的更新或版本。 對於所有其他支援的 Visual Studio 版本，您必須建立對應至新專案名稱的新本機工作區。
本機工作區是本地管理的，而不是在伺服器上管理的。 沒有更新重新命名邏輯的較舊客戶端無法將本機工作區更新為新的項目名稱。
更新 OData 摘要
如果您在Power BI 中使用 OData 摘要，請更新摘要 URL 以使用新的項目名稱。 更新摘要 URL 是維護數據連線並避免報告錯誤的必要條件。 如需詳細資訊，請參閱 使用 OData 查詢的範例報表概觀。
更新分析檢視
如果您使用舊專案名稱建立自定義分析檢視，則必須以新名稱更新檢視。 如需詳細資訊，請參閱 分析檢視。
相關內容
常見問題集 (FAQ)
問：為什麼我的嘗試重複使用專案名稱因為現有的工作空間而失敗？
答：如果仍有工作區映射尋址，則無法重新使用專案名稱。 此函式有助於避免將工作區對應至兩個專案的模棱兩可案例。 請連絡具有這些對應的使用者，並刪除或 更新它們以使用新的名稱。
如果已不再提供包含工作區的用戶計算機，您可以從 Visual Studio 的開發人員命令提示字元執行下列命令來刪除工作區： tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner]
問：重新命名專案如何影響我的瀏覽器瀏覽體驗？
答：重新命名項目之後，任何開啟專案的瀏覽器都可能會遇到一些錯誤。 這些錯誤是因為瀏覽器的快取中包含了舊專案名稱。 重新整理以讓這些錯誤消失，因為快取記憶體會重新填入新的專案名稱。
問：專案中的其他成品是否重新命名？
答：是，所有共用相同名稱的成品都會隨著專案一起重新命名。 唯一的例外是適用於預設團隊和存放庫。 這些項目的重新命名是按最佳努力原則進行的。 例如，如果專案 Foo 已重新命名為 Bar，如果專案中已有名為 Bar 的小組，則預設小組 Foo 將不會重新命名。
問：為什麼無法在重新命名之後開啟儲存至磁碟的查詢？
答：如果您使用 Visual Studio 2010，而且有查詢儲存至磁碟，則無法在重新命名項目之後加以開啟。 您可以使用 Visual Studio 2012 或更新版本來開啟它們。