Localversions command (Team Foundation Version Control)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

The Team Foundation Version Control (TFVC) localversions command displays the version of one or more items in a workspace.

Prerequisites

To use the localversions command, you must have the Use permission to the workspace. For more information, see Default TFVC permissions.

Syntax

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

Parameters

Arguments

Argument

Description

<itemspec>

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 isn't valid.

Note

You can specify more than one itemspec argument.

<workspacename>

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

<workspaceowner>

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

<TeamProjectCollectionUrl>

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

Options

Option

Description

/format

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.

/recursive

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

/workspace

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

/collection

Specifies the project collection.

Remarks

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 TFVC. You can use the localversions command to get information about which versions of these files are in your workspace.

Other TFVC commands provide more information about items in your server for TFVC and the workspaces that map to it. For more information on how to use the tf command-line utility, see Use Team Foundation version control commands.

Examples

The following example displays the version of the ControllerBase.cs file in the workspace that's 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's 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