Dir 命令 (Team Foundation 版本控制)

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

Visual Studio 2019 |Visual Studio 2022

dir 命令显示 Team Foundation 版本控制(TFVC)服务器的所有内容或部分内容。

先决条件

若要使用 命令,请将 读取 权限设置为“允许”。 有关详细信息,请参阅 默认 TFVC 权限

语法

tf dir itemspec [/version:versionspec] [/recursive] 
[/folders] [/deleted] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

参数

参数

参数

说明

<itemspec>

标识要返回相关信息的文件或文件夹。 若要详细了解 TFVC 如何分析 itemspec 以确定哪些项在范围内,请参阅 使用选项来修改命令如何

注意

可以指定多个 itemspec 参数。

<versionspec>

/version 选项的用户提供的值。 有关 TFVC 如何分析版本规范以确定其范围内哪些项的详细信息,请参阅 使用 Team Foundation 版本控制命令

<username>

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

<TeamProjectCollectionUrl>

项目集合的 URL,其中包含要显示信息的一个或多个文件或文件夹,例如 http://myserver:8080/tfs/DefaultCollection/

选项

选项

说明

/version

指定 TFVC 应仅显示特定版本的文件和文件夹。

/recursive

显示指定目录中的所有文件和子文件夹。

/folders

仅显示文件夹。

/deleted

显示已删除的项和现有项。 删除的项后跟 ;Xn 其中 n 是删除 ID。

/login

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

/collection

指定项目集合。

言论

dir 命令在文件的 Azure DevOps 服务器副本(而不是本地副本)上运行。 该命令使用本地映射文件夹查找相应的 Azure DevOps 服务器路径。 使用此命令浏览 Azure DevOps 服务器并标识可能需要获取的文件。

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

例子

以下示例显示 Azure DevOps 服务器文件夹中 c:\projects 映射到的文件、文件夹、子文件夹和文件的列表。 还会列出项数。 有关如何查看和编辑工作文件夹映射的详细信息,请参阅 工作区命令Workfold 命令

c:\projects>tf dir /recursive

以下示例显示 314dir 路径上的所有 Azure DevOps 服务器文件。 314dir 子文件夹不必存在于本地文件夹中。

c:\projects>tf dir 314dir

以下示例显示 314dir Azure DevOps 服务器路径中标记为 My label 的文件的版本。 314dir 子文件夹不必存在于本地文件夹中。

c:\projects>tf dir /version:L"My label" 314dir

以下示例显示 Azure DevOps 服务器的根目录中的所有文件夹。 本地工作文件夹将被忽略,因为 $/ 表示 Azure DevOps 服务器路径。

c:\projects>tf dir /folders $/

以下示例列出 Azure DevOps 服务器中的每个文件和文件夹。

c:\projects>tf dir /recursive $/

以下示例列出当前文件夹中的所有项目,包括已删除的项目及其删除 ID。

c:\projects>tf dir /deleted