Export (0) Print
Expand All
0 out of 1 rated this helpful - Rate this topic

Dir Command

The dir command displays all or some of the contents of the server for Team Foundation version control.

Required Permissions

To use the dir command, you must have Read permission set to Allow. For more information, see Team Foundation Server Permissions.

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

Argument

Description

itemspec

Identifies the file or folder to return information about. For more information about how Team Foundation parses itemspecs to determine which items are within scope, see Command-Line Options.

NoteNote
You can specify more than one Itemspec argument.

versionspec

The user-provided value for the /version option. For more information about how Team Foundation parses a version specification to determine which items are within its scope, see Command-Line Syntax (Version Control).

username

Provides a value to the /login option. You can specify a username value as either DOMAIN\UserName or UserName.

TeamProjectCollectionUrl

The URL of the team project collection that contains one or more files or folders about which you want to display information (for example, http://myserver:8080/tfs/DefaultCollection/).

Option

Description

/version

Specifies that Team Foundation should only show files and folders of a certain version.

/recursive

Displays all files and subfolders in the specified directory.

/folders

Displays folders only.

/deleted

Displays deleted items and existing items. The deleted items are followed with ;X3 where 3 is the deletion id.

/login

Specifies the user name and password to authenticate the user with Visual Studio Team Foundation Server.

/collection

Specifies the team project collection.

The dir command operates on the Team Foundation version control server copies of files, not the local copies. The command uses the local mapped folder to locate the appropriate Team Foundation version control server path. You use this command to explore the Team Foundation version control server and identify files you may have to obtain.

For links to other Team Foundation commands that provide additional information about items in your Team Foundation version control server and the workspaces that map to it, see Informational Commands.

For more information on how to find the tf command-line utility, see Tf Command-Line Utility Commands.

The following example displays a list of files, folders, subfolders, and the files therein in the Team Foundation version control server folder to which c:\projects maps. The number of items is also listed. For more information about how to view and edit working folder mappings, see Workspace Command and Workfold Command.

c:\projects>tf dir /recursive

The following example displays all Team Foundation version control server files at that path. The "314dir" subfolder does not have to exist in the local folder.

c:\projects>tf dir 314dir

The following example displays the version of files labeled "My label" in that Team Foundation version control server path. The "314dir" subfolder does not have to exist in the local folder.

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

The following example displays all folders in the root of the Team Foundation version control server. The local working folder is ignored because $/ denotes a Team Foundation version control server path.

c:\projects>tf dir /folders $/

The following example lists every file and folder in the Team Foundation version control server.

c:\projects>tf dir /recursive $/

The following example lists all items and deleted items in the current folder together with their deletion IDs.

c:\projects>tf dir /deleted
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.