Share via

重新命名指令 （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