重新命名指令 （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 命令，您必須將 [取出 ] 許可權設定為 [允許]。 如需詳細資訊，請參閱 預設 TFVC 許可權。
語法
tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem
參數
引數
Argument
說明
<olditem>
要重新命名之檔案或資料夾的原始名稱和路徑。 您可以指定本機工作區路徑，例如 C：\myfiles\314.cs 或 TFVC 伺服器路徑，例如 $/myfiles/314.cs。
<newitem>
檔案或資料夾的新名稱。 您可以使用此選項來指定不同的本機或 TFVC 伺服器路徑位置。
<username>
提供 選項的值 /login 。 您可以將使用者名稱值指定為 DOMAIN\username 或 username。
選項。
選項
說明
/lock
包含此選項，以防止其他使用者簽入或簽出指定的專案。 如果未指定此選項，則不會變更專案的現有鎖定狀態。 如需詳細資訊，請參閱 瞭解鎖定類型。
鎖定選項：
None：未套用鎖定。Checkin：其他使用者可以簽出指定的專案，但除非您執行簽入來釋放鎖定，否則無法簽入鎖定檔案的修訂。 如果任何其他使用者已鎖定任何一個指定的專案，鎖定作業就會失敗。Checkout：防止其他使用者簽入或簽出任何一個指定的專案，直到您執行簽入來釋放鎖定為止。 如果任何其他使用者已鎖定任何一個指定的專案，鎖定作業就會失敗。
/login
指定要向 Azure DevOps 驗證使用者的使用者名稱和密碼。
備註
您可以使用 rename 命令列公用程式的 命令 tf ，在工作區中移動或重新命名版本控制的專案。 rename使用 命令藉由指定通配符來移動多個檔案。 只能從命令行使用重新命名多個版本控制的檔案或資料夾。
rename使用 命令來執行下列動作：
olditem重新命名為newitem，例如tf rename 314.cs 315.cs。olditem藉由提供newitem路徑與olditem的不同 ，例如tf rename 314.cs ..\newdir\314.cs，將 移至 TFVC 伺服器中的新位置。
如果您提供 newitem 指定不存在資料夾的 ， rename 命令會建立目的地資料夾。 如果 newitem 是資料夾， olditem 則成為的 newitem子系。
如果下列專案，則無法重新命名專案：
- 您已將它存回相同的工作區之前將其刪除。
- 新名稱已存在於 TFVC 伺服器中，而且不是資料夾。
- 您已新增、分支或重新命名項目的擱置簽入。
- 項目會對應到工作區中，但無法在本機磁碟上使用。
- 專案已遮蓋。
您可以重新命名專案，其中另一個相同名稱的檔案已新增擱置簽入，但無法重新命名已分支但尚未存入的專案。 當您重新命名具有擱置編輯的檔案時，會保留編輯。
若未先變更對應，就無法重新命名明確對應的專案。 例如，如果有工作資料夾對應 $/ProjectX/MyApp 至 c：\MyApp，則無法重新命名 MyApp。 您可以在 MyApp 底下重新命名專案，但無法重新命名 MyApp 本身。
如需如何使用 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