Dir 命令
更新：2007 年 11 月
dir 命令显示 Team Foundation 版本控制 服务器或 Team Foundation 版本控制 服务器一部分的内容。
必需的权限
若要使用 dir 命令，您必须将“读”权限必须设置为“允许”。有关更多信息，请参见 Team Foundation Server 权限。
tf dir [/server:servername] itemspec [/version:versionspec]
[/recursive] [/folders] [/deleted]
参数
参数 |
说明 |
|---|---|
servername |
用户提供的 /server 选项的值。示例：teamfoundation2。 |
itemspec |
标识要返回有关信息的文件或文件夹。有关 Team Foundation 如何分析项规范以确定哪些项在范围之内的更多信息，请参见命令行选项。 |
versionspec |
用户提供的 /version 选项的值。有关 Team Foundation 如何分析版本规范以确定哪些项在其范围内的更多信息，请参见命令行语法 (Team System)。 |
选项 |
说明 |
|---|---|
/server |
标识 Team Foundation Server。如果从未映射到工作区的目录调用命令，则此选项是必需的。 |
/version |
指定 Team Foundation 只应显示某个版本的文件和文件夹。 |
/recursive |
显示指定目录中的所有文件和子文件夹。 |
/folders |
只显示文件夹。 |
/deleted |
显示已删除项和现有项。已删除项后跟 ;X3，其中 3 为删除 ID。 |
备注
dir 命令对文件的 Team Foundation 版本控制 服务器副本（而不是本地副本）进行操作。本地映射文件夹用于查找要显示的适当 Team Foundation 版本控制服务器路径。可以使用该命令来浏览 Team Foundation 版本控制 服务器并识别您可能需要获取的文件。
有关指向其他 Team Foundation 命令的链接（这些命令提供有关 Team Foundation 版本控制 服务器和映射到该服务器的工作区中的项的其他信息），请参见信息性命令。
有关如何查找 tf 命令行实用工具的更多信息，请参见 Tf 命令行实用工具命令。
示例
下面的示例显示文件、文件夹、子文件夹以及 c:\projects 映射到的 Team Foundation 版本控制 服务器文件夹中文件的列表。还将列出项数。有关如何查看和编辑工作文件夹映射的更多信息，请参见Workspace 命令 和 Workfold 命令。
c:\projects>tf dir /recursive
下面的示例显示位于该路径中的所有 Team Foundation 版本控制服务器文件。“314dir”子文件夹不必存在于本地文件夹中。
c:\projects>tf dir 314dir
下面的示例显示该 Team Foundation 版本控制服务器路径中标有“My label”的文件的版本。“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