通过

删除命令 （Team Foundation 版本控制）

  • 项目

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 |Visual Studio 2022

delete 命令从 Azure DevOps 服务器中删除文件和文件夹，并将其从磁盘中删除。

注意

在执行签入操作之前，此命令的结果在其他工作区中不可见。 有关详细信息，请参阅 开发代码和管理挂起的更改。

先决条件

若要使用 命令，请将 签出 权限设置为“允许。 如果将 /lock 选项包含除 none以外的值，请将 锁定 权限设置为 “允许”。 还必须拥有工作区，或者拥有全局 管理工作区， 权限设置为 “允许”。 有关详细信息，请参阅 默认 TFVC 权限。

语法

tf delete [/lock:(none|checkin|checkout)] [/recursive] [/login:username,[password]] itemspec

参数

参数

参数

说明

<itemspec>

标识要从 Azure DevOps 服务器中删除的文件或文件夹。 有关 TFVC 如何分析 itemspec 以确定哪些项在范围内的详细信息，请参阅 使用选项来修改命令如何。

注意

可以指定多个 itemspec 参数。

<username>

为 /login 选项提供值。 可以将用户名值指定为 DOMAIN\username 或 username。

选项

选项

说明

/lock

阻止其他用户签入或签出指定的项目。 有关详细信息，请参阅 了解锁类型。

锁定选项：

  • none
    违约。 未应用锁。 如果已将锁置于指定文件上，此选项将将其删除。 它不会删除其他人放置的锁。

  • checkin
    其他用户可以签出指定的项，但在通过执行签入释放锁定之前，他们无法签入锁定文件的修订。 如果任何其他用户锁定了任一指定项，则锁定操作将失败。

  • checkout
    防止其他用户签入或签出任何一个指定项目，直到通过执行签入来释放锁。 如果任何其他用户锁定了任一指定项，则锁定操作将失败。

/recursive

从指定目录中删除与 itemspec 匹配的所有文件和/或文件夹和子文件夹。

  • tf delete <folder1>\<folder2> /recursive 删除 <folder1>\<folder2>包含的所有文件和子目录，<folder1>\<folder2> 本身。
  • tf delete <folder1>\<folder2> <filespec> /recursive 删除与 <folder1>\<folder2> 及其每个子目录中包含的 filespec 匹配的所有文件和子目录，以及与 filespec匹配的任何目录中包含的所有文件和子目录。

例如，在包含：

Folder1\AVeryLongDirectoryName，其中包含一些文件，Folder1\Folder2\AVeryImportantFile.txt，

tf delete Folder1 AVer* /recursive

删除 Folder1\AVeryLongDirectoryName 及其所有文件，并删除 Folder1\Folder2\AVeryImportantFile.txt，因为它与通配符匹配。

/login

指定使用 Azure DevOps 对用户进行身份验证的用户名和密码。

言论

delete 命令将记录工作区中 delete 类型的挂起更改，用于指定项。 使用 checkin 命令将类型 delete 挂起的更改提交到 Azure DevOps 服务器时，TFVC 会从 Azure DevOps 服务器中删除该项，但不会将其永久删除。 可以使用 dir 命令在 Azure DevOps 服务器中找到已删除的项，并且可以使用 Undelete 命令还原已删除的项。

如果删除了工作区中的项但尚未签入更改，则可以使用 撤消命令将项还原到工作区，并从挂起的更改列表中删除删除。

无法删除存在另一个挂起更改的项。 例如，无法删除签出的文件。 若要删除此类项，必须使用 undo 命令撤消当前挂起的更改。

签入挂起的删除时，TFVC 会将文件标记为在 Azure DevOps 服务器中删除。 随后，从其他工作区运行项目 get（由你或其他用户）从这些工作区中删除该项目。

当 itemspec 指定文件夹时，TFVC 默认删除其所有文件和子文件夹及其包含的文件。

有关如何使用 tf 命令行实用工具的详细信息，请参阅 使用 Team Foundation 版本控制命令。

例子

以下示例删除指定本地工作区文件夹中的磁盘上的 314.cs，然后在签入更改时，从版本控制系统中删除 314.cs 非永久删除。

tf delete 314.cs