取消删除命令 （Team Foundation 版本控制）
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制（TFVC）undelete 命令还原以前删除的项。
注意
在执行签入操作之前，此命令的结果在其他工作区中不可见。 有关详细信息，请参阅 开发代码和管理挂起的更改。
先决条件
若要使用 undelete 命令，
- 将 签出 权限设置为 “允许”。
- 如果将
/lock选项包含除None以外的值，请将 锁定 权限设置为 “允许”。 - 你必须拥有工作区或拥有全局 管理工作区 权限设置为 “允许”。
有关详细信息，请参阅 默认 TFVC 权限。
语法
tf undelete [/noget] [/lock:(none|checkin|checkout)]
[/recursive] <item-specification>[;<deletion-ID>] [/login:<username>,[<password>]]
参数
以下部分介绍 undelete 命令的参数和选项。
参数
| 论点 | 描述 |
|---|---|
<item-specification> |
标识要还原的文件或文件夹。 有关 TFVC 如何分析 <item-specification> 值以确定哪些项在范围内的详细信息，请参阅 使用 Team Foundation 版本控制命令。 |
<deletion-ID> |
指定一个唯一标识符，该标识符消除多个具有相同名称的已删除项。 |
<username> |
为 /login 选项提供值。 可以将此值指定为 DOMAIN\<username> 或 <username>。 |
选项
选项
说明
/noget
将已删除的项还原到工作区。 等待签入操作完成，此选项随后将还原服务器上的项，但不会立即检索项的物理副本到磁盘。
/lock
阻止其他用户签入或签出指定的文件。 有关详细信息，请参阅 了解锁类型。
锁定选项：
-
None：此选项为默认值。 未应用锁。 -
Checkin：其他用户可以签出指定的项目，但在通过签入锁定文件释放锁定之前，他们无法签入锁定文件的修订。 如果任何其他用户锁定了任何指定项，则锁定操作将失败。 -
Checkout：此选项阻止其他用户签入或签出任何指定的项目，直到通过签入锁定文件释放锁定为止。 如果任何其他用户锁定了任何指定项，则锁定操作将失败。
/recursive
从指定目录还原所有文件和子文件夹。
/login
指定使用 Azure DevOps 对用户进行身份验证的用户名和密码。
言论
tf 命令行功能的 undelete 命令计划指定的文件或文件夹，以便在签入操作完成之前进行还原。 它还从服务器检索到本地磁盘的指定项，除非显式包含 /noget 选项。
从同一服务器文件夹中删除具有相同名称的文件或文件夹时，必须包含 <deletion-ID> 参数的值，以指示要还原的已删除项目之一。 可以使用 dir 命令获取 <deletion-ID>。
如果要在还原文件后更改文件，请查看该文件，以便像往常一样使用 checkout 命令进行编辑。
当 <item-specification> 值指定文件夹时，TFVC 默认还原所有文件夹的文件和子文件夹及其包含的文件。 如果不想还原文件夹中的所有项目，必须先取消删除文件夹及其项，然后删除不想保留的项目。
有关如何使用 tf 命令行实用工具的详细信息，请参阅 使用 Team Foundation 版本控制命令。
例子
以下示例将 314.cs 还原到从中删除 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
以下示例将 X11 版本的 314.cs 还原到文件从中删除的服务器文件夹。 该命令还会检索当前工作区中最新版本的只读副本。
c:\projects>tf undelete 314.cs;X11