重新命名指令 （Team Foundation 版本控制）
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制 （TFVC） rename 命令會變更檔案或資料夾的名稱或路徑。 您可以使用 rename 命令或別名 move 或 ren，將檔案或資料夾移至新位置。
注意
執行簽入之前，此命令的結果不會反映在伺服器中。 如需詳細資訊，請參閱 開發程式代碼和管理擱置中的變更。
先決條件
若要使用 rename 命令，請將 [簽出 權限設定為 Allow。 如需詳細資訊，請參閱 預設 TFVC 權限。
語法
tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem
參數
參數
自變數
描述
<olditem>
要重新命名之檔案或資料夾的原始名稱和路徑。 您可以指定本機工作區路徑，例如 C：\myfiles\314.cs 或 TFVC 伺服器路徑，例如 $/myfiles/314.cs。
<newitem>
檔案或資料夾的新名稱。 您可以使用此選項來指定不同的本機或 TFVC 伺服器路徑位置。
<username>
提供值給 [/login] 選項。 您可以將使用者名稱值指定為 DOMAIN\username 或 username。
選項
選項
描述
/lock
包含此選項，以防止其他使用者簽入或簽出指定的專案。 如果未指定此選項，則不會變更專案的現有鎖定狀態。 如需詳細資訊，請參閱 瞭解鎖定類型。
鎖定選項：
-
None：未套用鎖定。 -
Checkin：其他使用者可以簽出指定的專案，但除非您執行簽入來釋放鎖定，否則無法簽入鎖定檔案的修訂。 如果任何其他使用者已鎖定任何一個指定的專案，鎖定作業就會失敗。 -
Checkout：防止其他使用者簽入或簽出任何一個指定的專案，直到您執行簽入來釋放鎖定為止。 如果任何其他使用者已鎖定任何一個指定的專案，鎖定作業就會失敗。
/login
指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。
言論
您可以使用 tf 命令行公用程式的 rename 命令，在工作區中移動或重新命名版本控制的專案。 使用 rename 命令，藉由指定通配符來移動多個檔案。 只能從命令行使用重新命名多個版本控制的檔案或資料夾。
使用 rename 命令來執行下列動作：
- 將
olditem重新命名為newitem，例如tf rename 314.cs 315.cs。 - 藉由提供路徑與
olditem不同的newitem，例如tf rename 314.cs ..\newdir\314.cs，將olditem移至 TFVC 伺服器中的新位置。
如果您提供指定不存在資料夾的 newitem，rename 命令會建立目的地資料夾。 如果 newitem 是資料夾，olditem 會變成 newitem的子系。
如果下列專案，則無法重新命名專案：
- 您已將它存回相同的工作區之前將其刪除。
- 新名稱已存在於 TFVC 伺服器中，而且不是資料夾。
- 您已新增、分支或重新命名項目的擱置簽入。
- 項目會對應到工作區中，但無法在本機磁碟上使用。
- 專案已遮蓋。
您可以重新命名專案，其中另一個相同名稱的檔案已新增擱置簽入，但無法重新命名已分支但尚未存入的專案。 當您重新命名具有擱置編輯的檔案時，會保留編輯。
若未先變更對應，就無法重新命名明確對應的專案。 例如，如果
如需如何使用 tf 命令行公用程式的詳細資訊，請參閱 使用 Team Foundation 版本控制命令。
例子
下列範例會將 314.cs 的名稱變更為 1254.cs。
c:\projects>tf rename 314.cs 1254.cs
下列範例會將 314.cs 重新命名為 1254.cs，並將它移至 newdir 資料夾。
c:\projects>tf rename 314.cs ..\newdir\1254.cs
下列範例會將 Form1.vb 的名稱變更為 MainPage.vb，並將鎖定套用至它。
c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin