Dir 命令
dir 命令显示 Team Foundation 版本控制 服务器的部分或全部内容。
所需权限
若要使用 dir 命令，您必须将**“读”权限必须设置为“允许”**。 有关更多信息，请参见 Team Foundation Server 权限。
tf dir itemspec [/version:versionspec] [/recursive]
[/folders] [/deleted] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
参数
参数 |
说明 |
|---|---|
itemspec |
标识要返回有关信息的文件或文件夹。 有关 Team Foundation 如何分析项规范以确定哪些项在范围之内的更多信息，请参见命令行选项。 .gif "注意") 注意
可指定多个 Itemspec 参数。
|
versionspec |
用户提供的 /version 选项的值。 有关 Team Foundation 如何分析版本规范以确定哪些项在其范围内的更多信息，请参见命令行语法（版本控制）。 |
username |
向 /login 选项提供值。 可以按域\用户名或用户名的格式指定用户名值。 |
TeamProjectCollectionUrl |
您要显示其信息的一个或多个文件或文件夹所在的团队项目集合的 URL（例如，http://myserver:8080/tfs/DefaultCollection/）。 |
选项 |
说明 |
|---|---|
/version |
指定 Team Foundation 只应显示某个版本的文件和文件夹。 |
/recursive |
显示指定目录中的所有文件和子文件夹。 |
/folders |
只显示文件夹。 |
/deleted |
显示已删除项和现有项。 已删除项后跟 ;X3，其中 3 为删除 ID。 |
/login |
指定用于在 Visual Studio Team Foundation Server 中验证用户身份的用户名和密码。 |
/collection |
指定团队项目集合。 |
备注
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