Rename 命令(Team Foundation 版本控制)
rename 命令更改文件或文件夹的名称或路径。 可以使用 rename 命令或者别名 move 或 ren 将文件或文件夹移至新位置。
提示
在您执行签入操作之前,此命令的结果不会反映在 Team Foundation 版本控制 服务器中。 有关更多信息,请参见 签入挂起的更改。
所需权限
若要使用 rename 命令,您必须将**“签出”权限设置为“允许”**。 有关更多信息,请参见 Team Foundation Server 权限。
tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem
参数
参数 |
说明 |
---|---|
旧项 |
要重命名的文件或文件夹的原始名称和路径。 可以指定本地工作区路径(如 C:\myfiles\314.cs)或 Team Foundation 版本控制 服务器路径(如 $/myfiles/314.cs)。 |
新项 |
文件或文件夹的新名称。 可以使用此参数来指定不同的本地路径位置或 Team Foundation 版本控制 服务器路径位置。 |
用户名 |
向 /login 选项提供值。 可以按域\用户名或用户名的格式指定用户名值。 |
选项 |
说明 |
---|---|
/lock |
包含此选项可防止其他用户签入或签出指定的项。 如果未指定此选项,则不会改变项的现有锁定状态。 有关更多信息,请参见 了解锁定类型。 锁定选项:
|
/login |
指定用于在 Visual Studio Team Foundation Server 中验证用户身份的用户名和密码。 |
备注
可以使用 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 版本控制)