Undelete 命令

更新:2007 年 11 月

undelete 命令用于还原以前删除的项。

说明:

在您执行签入操作之前,其他工作区中无法看到此命令的结果。有关更多信息,请参见如何:签入挂起的更改

必需的权限

若要使用 undelete 命令,您必须将“签出”权限设置为“允许”。如果在 /lock 选项中包含一个非 none 值,则您必须将“锁定”权限设置为“允许”。此外,您必须是工作区的所有者或者将全局“管理工作区”权限设置为“允许”。有关更多信息,请参见 Team Foundation Server 权限

tf undelete [/noget] [/lock:(none|checkin|checkout)] [/newname:name] 
[/recursive] itemspec[;deletionID]

参数

参数

说明

name

用户提供的 /newname 选项的值。可以指定一个本地或服务器路径。

itemspec

标识要撤消删除的文件或文件夹。有关 Team Foundation 如何通过分析 itemspecs 确定范围内项的更多信息,请参见命令行语法 (Team System)

deletionID

指定一个唯一的标识符,该标识符区分多个具有相同名称的已删除项。

选项

说明

/noget

将已删除的项还原至工作区,然后,挂起签入操作,还原服务器上的项,但并不立即将该项的物理副本检索到磁盘。

/lock

防止其他用户签入或签出指定文件。有关更多信息,请参见了解锁定类型

锁定选项:

  • None

    默认值。不应用锁定。

  • Checkin

    其他用户可以签出指定的项,但在您执行签入前,他们无法签入对锁定文件的修订。如果任何其他用户已锁定任何一个指定的项,则锁定操作将失败。

  • Checkout

    在您执行签入从而释放锁之前,防止其他用户签入或签出任何一个指定的项。如果任何其他用户已锁定任何一个指定的项,则锁定操作将失败。

/newname

在还原项时对其重命名。

/recursive

还原指定目录的所有文件和子文件夹。

备注

tf 命令行功能的 Undelete 命令为还原挂起的签入操作安排指定的文件或文件夹。它还将指定的项从服务器检索到本地磁盘,除非您显式包含 /noget 选项。

当具有相同名称的文件或文件夹从同一个服务器文件夹中被删除时,您必须包含 deletionID 参数的值,以指示您要还原哪个(哪些)已删除的项。可以使用 dir 命令来获取 deletionID。

若要将一个已删除项还原到一个服务器文件夹(在该文件夹中,某个具有相同名称的项已存在或是挂起的新项),可以使用 /newname 选项为撤消删除的项指定一个新名称。使用 /newname 选项一次只能撤消删除一个项。

如果要在还原文件之后对其进行更改,可以照常使用 checkout 命令签出文件进行编辑。

当 itemspec 指定了一个文件夹时,默认情况下,Team Foundation 将还原该文件夹中的所有文件和子文件夹以及这些子文件夹所包含的文件。如果不想还原文件夹中的所有项,则必须首先撤消删除该文件夹及其项,然后删除不想保留的项。

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

示例

下面的示例将 314.cs 从其被删除之处还原到服务器文件夹中,并在当前工作区中检索最新版本的只读副本。

C:\projects>tf undelete c:\math\314.cs

下面的示例显示服务器上所有被删除过多次的项的删除 ID。

c:\projects>tf dir $/ /deleted
  • 示例输出:

    $/projects/math/314.cs;X10
    $/projects/math/314.cs;X11
    

下面的示例将 314.cs 的 X11 版本从其被删除之处还原至服务器文件夹,并在当前工作区中检索最新版本的只读副本。

c:\projects>tf undelete 314.cs;X11

请参见

概念

挂起的更改

了解锁定类型

参考

命令行语法 (Team System)

Rename 命令(Team Foundation 版本控制)

Delete 命令

Dir 命令

其他资源

Tf 命令行实用工具命令