LocalVersions Command

Last Update: 9/26/2016

Team Services | TFS 2015 | Visual Studio 2015 | Visual Studio 2013

Displays the version of one or more items in a workspace.

Required Permissions
To use the localversions command, you must have the Use permission to the workspace. For more information, see Team Foundation Server Permissions.

tf localversions ItemSpec
[/recursive] [/format:brief|detailed]
[/workspace:WorkspaceName[;WorkspaceOwner]] [/collection:TeamProjectCollectionUrl]





Specify either a file or a folder that contains the files for which you want to display version numbers.

You can specify only a local file or folder. For example, c:\project1\binder.cs is valid, but $/project1/binder.cs is not.

You can specify more than one Itemspec argument.


Use this argument with the /workspace option to specify a workspace other than the one that is mapped to the current directory.


Use this argument with the WorkSpaceName argument if you want to specify a public workspace.


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




Specify one of the following options to control how the data returned by this command appears:

  • Brief

    (Default.) Each directory appears only once, followed by the files that it contains.

  • Detailed

    Each file appears after its full path.


Specify this option if you want the operation to include items in subfolders.


Specify this option to display data about the versions of items that are in a workspace other than the one that is mapped to the current directory.


Specifies the team project collection.


When you get or check out a file, you usually download the most current version. However, you may have older versions of some files in your workspace.

For example, you might have checked out some files and not checked in your work for several weeks. Other people on your team may have checked in changes to the same files during that time. In this case, the versions of these files in your workspace would be older than the current versions on your server for Team Foundation version control. You can use the localversions command to get information about which versions of these files are in your workspace.

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

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


The following example displays the version of the ControllerBase.cs file in the workspace that is mapped to the c:\\workspaces\\FeatureA\\catalog\\controller folder.

c:\workspaces\FeatureA\catalog\controller>tf localversions ControllerBase.cs

The following example displays the versions of all files (including those in subfolders) in the workspace that is mapped to the c:\\workspaces\\FeatureA\\catalog\\ folder. Because the /format:detailed option is specified, each file appears with its full path.

c:\workspaces\FeatureA\catalog\>tf localversions . /recursive /format:detailed

See Also


Informational Commands

Other Resources

Tf Command-Line Utility Commands