共用方式為


重新命名指令 (Team Foundation 版本控制)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

Team Foundation 版本控制 (TFVC) rename 命令會變更檔案或資料夾的名稱或路徑。 您可以使用 rename 命令或別名 moveren,將檔案或資料夾移至新位置。

注意

執行簽入之前,此命令的結果不會反映在伺服器中。 如需詳細資訊,請參閱 開發程式碼和管理擱置中的變更

必要條件

若要使用 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\usernameusername

選項。

選項

說明

/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