在Azure DevOps Server （TFS） 中修改團隊專案名稱
概述
【團隊專案】：
在Azure DevOps Server （原名TFS）中，團隊專案（Team Project）是一個最基本的資料組織容器，包含了一個團隊或者資訊系統中的所有資訊，包括原始碼、文件、需求、缺陷和持續整合等資料。同時，團隊專案也是TFS中相關資料的許可權隔離邊界；在系統的預設配置中，不同人員登入TFS系統，會檢視到不同團隊專案的資料。在TFS系統的設計中，團隊專案名稱和使用者訪問TFS系統的方式有直接關係，例如，團隊專案中程式碼庫的遠端地址中，就包含了團隊專案的名稱部分。
【修改名稱】：
在使用TFS系統前，最好對所有團隊專案的名稱有一個整體的規劃，避免由於改名導致許多未知的問題。但是，如果出現團隊專案改名的需求時，我們需要首先了解改名對開發團隊造成的影響，提前做好相應的規劃。
團隊專案改名會導致使用者相關資料的變化，包括：
- 原始碼版本庫路徑
- 工作項的URL路徑
- 共享查詢、個人查詢路徑
- 其他與團隊專案名稱相關的書
團隊專案的名稱可以多次修改，也可以重新改回原來的名稱。但是在改名之前和之後，必須要通知你的開發團隊，讓大家做好相應的變更。一般情況下，儘量在非工作時間實施改名的工作，避免對開發團隊的工作造成影響。
注意：從TFS 2015之後，系統才支援修改團隊專案名稱的功能，之前的版本並不支援這一功能。
修改團隊專案之前
1. 你必須是專案管理員的許可權，即，你的操作賬戶在專案管理員組的成員中
2. 由於修改團隊專案會影響開發人員訪問Azure DevOps Server，為避免修改團隊專案造成資料丟失，在修改團隊專案之前，需要通知開發團隊將本地的程式碼變更提交到伺服器。提交的資料主要包括：
- Git程式碼庫中的修改
- TFVC程式碼庫中的修改
- Excel 中的工作項
- Project 中的工作項
- PowerPoint 中的設計內容
修改團隊專案名稱
在團隊專案的任何頁面，點選“專案設定”按鈕
‘
在專案設定頁面，點選重新命名
在彈出頁面中，填寫新的團隊專案名稱，並勾選“我瞭解重新命名此專案的後果”，點選“重新命名”按鈕。
修改團隊專案之後：對開發團隊的影響
完成團隊專案改名後，我們必須通知開發團隊，對本地開發工具和訪問方式做相應的修改，以便適應新的團隊專案名稱。這些變動主要是正對使用不同開發工具的團隊成員，如果你的團隊成員（例如需求人員）一直使用瀏覽器訪問TFS系統，則變動不大。下面是開發團隊需要做的相應調整：
1. 重新啟動客戶端：
開發工具在快取中儲存團隊專案名稱，如果重新啟動開發工具，系統會自動清除快取中的資訊。重新開啟開發工具並連線到Azure DevOps Server 後，系統會自動建立新快取資訊。如果在修改團隊專案名稱後，使用者沒有重新啟動客戶端程式，會導致推送到伺服器的資料失敗。當然，這裡的客戶端不包含瀏覽器，主要是指Visual Studio，Eclipse，Git client，Excel等工具，以及使用TFS客戶端物件模型自定義的客戶端工具。
2. 更新Git遠端庫：
如果你使用的團隊專案中的Git 遠端庫，那麼你需要更新所有連線到伺服器本地庫的配置。這是因為遠端庫的地址中包含了團隊專案的名稱，例如http://tfsserver/DefaultCollection/MyAgileTeam/_git/MyAgileTeam，其中的MyAgileTeam就是團隊專案名稱。
- 獲取遠端庫的名稱
在瀏覽器中，選擇對應的Git庫，選擇克隆按鈕，在彈出的視窗中，點選複製Git庫遠端地址的按鈕
- 在Visual Studio 中，請參考下面的方式修改遠端庫地址
在Visual Studio 的團隊資源管理器中開啟之前克隆的git庫：
選擇設定按鈕
選擇儲存庫設定
選擇遠端庫>編輯按鈕
在彈出的視窗中，將上一步中複製的遠端地址貼上到這裡，並確認完成操作。你就可以按照之前的操作更新原生代碼庫，並推送和拉取遠端庫的內容了。
- 在Git 客戶端的命令列中更新遠端庫地址
如果你使用命令列方式和遠端倉庫同步資料，則可以參考下面的方式修改遠端庫地址:
開啟命令列視窗，檢視當前的遠端庫設定：
git remote –a
執行遠端庫修改命令
git remote set-url origin {URL_you_copied_from_the_remote_repo}
3. 更新TFVC 工作區
如果你使用伺服器工作區的方式連線TFVC程式碼庫，你只需要開啟使用Visual Studio 或者Eclipse，開啟原始碼管理器之後，更新或者簽入檔案後，系統會在工具中自動更新你的團隊專案名稱。
常見問題
在Eclipse或者Visual Studio中連線TFVC異常，建議新建一個工作區，重新同步資料到新的對映目錄中，如下圖：
微軟最有價值專家，DevOps MVP 張洪君 http://www.cnblogs.com/danzhang
--End--
（完）