删除命令 (Team Foundation 版本控制)

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

Visual Studio 2022 |Visual Studio 2019 |Visual Studio 2017 |Visual Studio 2015 |Visual Studio 2013

从 Team Foundation 版本控制服务器中删除文件和文件夹,并将其从磁盘中删除。

注意

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

先决条件

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

语法

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

参数

参数

Argument

说明

itemspec

标识要从 Team Foundation 版本控制服务器中删除的文件或文件夹。 有关 Team Foundation 如何分析 itemspecs 以确定哪些项在范围内的详细信息,请参阅 使用 Team Foundation 版本控制命令,使用选项修改命令的工作原理

注意

可以指定多个 Itemspec 参数。

username

/login 选项提供值。 可以将用户名值指定为 DOMAINemUserName <>或 UserName。

选项

选项

说明

/lock

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

锁定选项:


  • 默认。 未应用锁。 如果已将锁放在指定文件上,则此选项将删除它。 它不会删除其他人放置的锁。

  • 签入
    其他用户可以签出指定的项,但除非通过执行签入来释放锁定,否则无法签入锁定的文件的修订。 如果任何其他用户锁定了任何一个指定项,锁定操作将失败。

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

/递归

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

  • tf delete folder1\folder2 /recursive (where folder1\folder2 exists, is a directory) deletes all the files and subdirectories by folder1\folder2 and folder1\folder2 本身。
  • tf delete folder1\folder2\filespec /recursive deletesive delete all files and subdirectories matching filespec in folder1\folder2 及其每个子目录,以及任何与 filespec 匹配的目录中包含的所有文件和子目录。

例如,在包含:

Folder1\AVeryLongDirectoryName (,其中包含) 和Folder1\Folder2\AVeryImportantFile.txt

tf 删除“Folder1\AVer” /recursive

删除folder1\folder2\NeverDelete\AVeryImportantFile.txt,因为它与通配符匹配。

/login

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

注解

删除命令记录工作区中指定项的“delete”类型的挂起更改。 使用 签入 命令将“delete”类型的挂起更改提交到 Team Foundation 版本控制服务器时,Team Foundation 将从 Team Foundation 版本控制服务器中删除该项目,但不永久删除它。 可以使用 Dir 命令在 Team Foundation 版本控制服务器中找到已删除的项目,还可以使用 Undelete 命令还原已删除的项目。

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

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

签入挂起的删除时,Team Foundation 会将文件标记为在 Team Foundation 版本控制服务器中删除。 随后,从其他工作区运行项 (由你或其他用户) 从这些工作区中删除该项目。

当 itemspec 指定文件夹时,Team Foundation 默认会删除其所有文件和子文件夹及其包含的文件。

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

示例

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

c:\projects>tf delete 314.cs