Rename 命令（Team Foundation 版本控制）

更新：2007 年 11 月

rename 命令更改文件或文件夹的名称或路径。可以使用 rename 命令或者别名 move 或 ren 将文件或文件夹移至新位置。

说明：
在您执行签入操作之前，此命令的结果不会反映在 Team Foundation 版本控制服务器中。有关更多信息，请参见如何：签入挂起的更改。

必需的权限

若要使用 rename 命令，您必须将“签出”权限设置为“允许”。有关更多信息，请参见 Team Foundation Server 权限。

tf rename [/lock:(none|checkout|checkin)] olditem newitem

参数

参数	说明
旧项	要重命名的文件或文件夹的原始名称和路径。可以指定本地工作区路径（如 C:\myfiles\314.cs）或 Team Foundation 版本控制服务器路径（如 $/myfiles/314.cs）。
新项	文件或文件夹的新名称。可以使用此参数来指定不同的本地路径位置或 Team Foundation 版本控制服务器路径位置。

选项	说明
/lock	包含此选项可防止其他用户签入或签出指定的项。如果未指定此选项，则不会改变项的现有锁定状态。有关更多信息，请参见了解锁定类型。锁定选项： None 不应用锁定。 Checkin 其他用户可以签出指定的项，但在您执行签入从而释放锁之前，他们无法签入对锁定文件的修订。如果任何其他用户已锁定任何一个指定的项，则锁定操作将失败。 Checkout 在您执行签入从而释放锁之前，防止其他用户签入或签出任何一个指定的项。如果任何其他用户已锁定任何一个指定的项，则锁定操作将失败。

/lock

包含此选项可防止其他用户签入或签出指定的项。如果未指定此选项，则不会改变项的现有锁定状态。有关更多信息，请参见了解锁定类型。

锁定选项：

None 不应用锁定。
Checkin 其他用户可以签出指定的项，但在您执行签入从而释放锁之前，他们无法签入对锁定文件的修订。如果任何其他用户已锁定任何一个指定的项，则锁定操作将失败。
Checkout 在您执行签入从而释放锁之前，防止其他用户签入或签出任何一个指定的项。如果任何其他用户已锁定任何一个指定的项，则锁定操作将失败。

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

可以使用 Rename 命令执行以下操作：

将 olditem 重命名为 newitem，例如 tf rename 314.cs 315.cs。
通过提供一个与 olditem 具有不同路径的 newitem，将 olditem 移至 Team Foundation 版本控制服务器中的新位置，例如 tf rename 314.cs ..\newdir\314.cs。

如果您提供的 newitem 指定了不存在的文件夹，rename 命令会创建目标文件夹。如果 newitem 是文件夹，则 olditem 会成为 newitem 的子级。

在以下情况，您无法重命名项：

如果与项名称相同的另一个文件已被添加了挂起的签入，则您可以重命名该项；但您无法重命名已分支但尚未签入的项。当您重命名具有挂起编辑的文件时，将保留这些编辑。

显式映射的项如果不首先更改映射则无法重命名。例如，如果存在 $/ProjectX/MyApp 到 c:\MyApp 的工作文件夹映射，则不能重命名 MyApp。可以重命名 MyApp 下的项，但不能重命名 MyApp 本身。

有关如何查找 tf 命令行实用工具的更多信息，请参见 Tf 命令行实用工具命令。

下面的示例将 314.c 的名称更改为 1254.c。

c:\projects>tf rename  314.c  1254.c

下面的示例将 314.c 重命名为 1254.c 并将其移至 newdir 文件夹。

c:\projects>tf rename 314.c ..\newdir\1254.c

下面的示例将 Form1.vb 的名称更改为 MainPage.vb 并向其应用锁定。

c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin