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

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Visual Studio 2022 |Visual Studio 2019 |Visual Studio 2017 |Visual Studio 2015 |Visual Studio 2013

重命名命令更改文件或文件夹的名称或路径。 可以使用 重命名 命令或别名 移动ren,将文件或文件夹移动到新位置。

注意

在执行签入操作之前,此命令的结果不会反映在 Team Foundation 版本控制服务器中。 有关详细信息,请参阅 开发代码并管理挂起的更改

先决条件

若要使用 重命名 命令,请将 “签出 ”权限设置为 “允许”。 有关详细信息,请参阅 默认 TFVC 权限

语法

tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem

参数

参数

Argument

说明

olditem

要重命名的文件或文件夹的原始名称和路径。 可以指定本地工作区路径,例如 C:\myfiles\314.cs 或 Team Foundation 版本控制服务器路径,例如 $/myfiles/314.cs。

newitem

文件或文件夹的新名称。 可以使用此选项指定不同的本地或 Team Foundation 版本控制服务器路径位置。

username

提供 /login 选项的值。 可以将用户名值指定为 DOMAIN\UserNameUserName

选项

选项

说明

/lock

包括此选项以防止其他用户签入或签出指定项目。 如果未指定此选项,则不会更改项的现有锁定状态。 有关详细信息,请参阅 了解锁类型

锁定选项:

  • 没有 未应用锁。
  • 签入 其他用户可以通过执行签入来签入来签入锁定文件,但无法签入已锁定的文件的修订。 如果任何其他用户锁定了任一指定项,则锁定操作将失败。
  • 结帐 防止其他用户签入或签出任何指定项目,直到通过执行签入来释放锁。 如果任何其他用户锁定了任一指定项,则锁定操作将失败。

/login

指定使用Azure DevOps对用户进行身份验证的用户名和密码。

注解

可以使用 tf 命令行实用工具的 rename 命令移动或重命名工作区中的版本控制项。 使用 rename 命令通过指定通配符移动多个文件。 重命名多个版本控制的文件或文件夹的功能仅在命令行中可用。

使用 rename 命令执行以下操作:

  • olditem 重命名为 newitem,例如tf rename 314.cs 315.cs
  • olditem 移动到 Team Foundation 版本控制服务器中的新位置,方法是提供一个新 ,其路径与 旧项的路径不同,例如 tf rename 314.cs ..\\newdir\\314.cs

如果提供一个指定不存在的文件夹 的新项则 rename 命令将创建目标文件夹。 如果 newitem 是文件夹, olditem 将成为 newitem 的子级。

如果:

  • 在签入同一工作区之前,你已将其删除。
  • Team Foundation 版本控制服务器中已存在新名称,不是文件夹。
  • 已添加、分支或重命名项的挂起签入。
  • 该项在工作区中映射,但在本地磁盘上不可用。
  • 该项是遮盖的。

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

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