Dir 命令

Azure DevOps Services |Azure DevOps Server 2022 |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

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

先决条件

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

语法

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

参数

参数

Argument

说明

itemspec

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

注意

可以指定多个 Itemspec 参数。

versionspec

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

username

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

TeamProjectCollectionUrl

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

选项

选项

说明

/version

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

/递归

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

/folders

仅显示文件夹。

/deleted

显示已删除的项和现有项。 已删除的项后跟 ;X3,其中 3 是删除 ID。

/login

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

/collection

指定项目集合。

注解

dir 命令对文件(而不是本地副本)的 Team Foundation 版本控制服务器副本进行操作。 该命令使用本地映射文件夹查找相应的 Team Foundation 版本控制服务器路径。 使用此命令浏览 Team Foundation 版本控制服务器,并确定可能需要获取的文件。

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

示例

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

c:\projects>tf dir /recursive

以下示例显示该路径上的所有 Team Foundation 版本控制服务器文件。 “314dir”子文件夹不必存在于本地文件夹中。

c:\projects>tf dir 314dir

以下示例显示该 Team Foundation 版本控制服务器路径中标记为“我的标签”的文件的版本。 “314dir”子文件夹不必存在于本地文件夹中。

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

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

c:\projects>tf dir /folders $/

以下示例列出了 Team Foundation 版本控制服务器中的每个文件和文件夹。

c:\projects>tf dir /recursive $/

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

c:\projects>tf dir /deleted