Rename 命令（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 对用户进行身份验证。

注解

可以使用 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 服务器中并且不是文件夹。
  • 你已添加、分支或重命名了项的挂起的签入。
  • 项已映射到工作区，但在本地磁盘上不可用。
  • 项已掩蔽。

可以重命名已添加另一个同名文件以待签入的项，但无法重命名已分支但尚未签入的项。 重命名包含挂起的编辑的文件时，编辑将被保留。

如果不首先更改映射，则无法重命名显式映射的项。 例如，如果存在 $/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