更新：2007 年 11 月
rename 命令更改文件或文件夹的名称或路径。可以使用 rename 命令或者别名 move 或 ren 将文件或文件夹移至新位置。
.gif "说明") 说明： |
|---|
在您执行签入操作之前，此命令的结果不会反映在 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 |
包含此选项可防止其他用户签入或签出指定的项。如果未指定此选项，则不会改变项的现有锁定状态。有关更多信息，请参见了解锁定类型。 锁定选项：
|
备注
可以使用 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 的子级。
在以下情况，您无法重命名项：
在同一工作区中签入之前，已将该项删除。
新的名称已存在于 Team Foundation 版本控制 服务器中且不是文件夹。
挂起签入某项时，已添加或重命名该项，或者已经为其创建了分支。
项在工作区中被映射，但在本地磁盘上不可用。
项已掩蔽。
如果与项名称相同的另一个文件已被添加了挂起的签入，则您可以重命名该项；但您无法重命名已分支但尚未签入的项。当您重命名具有挂起编辑的文件时，将保留这些编辑。
显式映射的项如果不首先更改映射则无法重命名。例如，如果存在 $/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
请参见
任务
概念
参考
Delete 命令（Team Foundation 版本控制）