Dir 命令（Team Foundation 版本控制）
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
dir 命令显示 Team Foundation 版本控制 (TFVC) 服务器的全部或部分内容。
先决条件
若要使用 dir 命令，必须将“读取”权限设置为“允许”。 有关详细信息，请参阅默认 TFVC 权限。
语法
tf dir itemspec [/version:versionspec] [/recursive]
[/folders] [/deleted] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
参数
参数
Argument
说明
<itemspec>
标识要返回相关信息的文件或文件夹。 若要详细了解 TFVC 如何分析 itemspec 以确定哪些项在范围内，请参阅使用选项修改命令的运行方式。
注意
可指定多个 itemspec 参数。
<versionspec>
用户为 /version 选项提供的值。 若要详细了解 TFVC 如何分析版本规范以确定哪些项在其范围内，请参阅使用 Team Foundation 版本控制命令。
<username>
为 /login 选项提供值。 可将用户名值指定为 DOMAIN\username 或 username。
<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 版本控制命令。
示例
以下示例显示 c:\projects 映射到的 Azure DevOps 服务器文件夹中的文件、文件夹、子文件夹和文件的列表。 还列出了项的数量。 若要详细了解如何查看和编辑工作文件夹映射，请参阅 Workspace 命令和 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