Help command (Team Foundation Version Control)

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

Visual Studio 2019 | Visual Studio 2022

The tf help command displays information about syntax for tf command-line utility commands.

Prerequisites

Syntax

tf help <commandname>

Parameters

Argument

Argument

Description

<commandname>

Specifies a TFVC command for which to display help about the syntax.

Remarks

  • If you don't know which command you need, enter:

    • tf vc help for a list of supported TFVC commands.
    • tf git help for a list of supported Git commands.
    • tf settings help for a list of supported server settings commands.
  • If you specify the commandname parameter, the command line displays information about the arguments and options for that command. If the system can't find a match for the commandname, it searches for aliases and short names. If it can't find any matching command, alias, or short name, you get an error.

  • The option /? is an alias for help. If you use the /? option with a command, the system invokes the help command and displays syntax information for the command you entered.

For more information on how to use the tf command-line utility, see Use Team Foundation version control commands.

Examples

List tf vc commands

The following example displays a list of the version control commands.

>tf vc help
Microsoft (R) TF - Team Foundation Version Control Tool, Version 16.171.31930.1
Copyright (c) Microsoft Corporation.  All rights reserved.

Type tf vc help <command name> for command line description.
Type tf msdn <command name> for full documentation in https://learn.microsoft.com.

Commands:
tf vc add            Adds new files and folders from a local file system
                     location to TFVC.

tf vc branch         Copies an item or set of items, including metadata and
                     version control history, from one location to another on
                     the Azure DevOps server and in the workspace.

tf vc branches       Displays the history of a branch for a specified file
                     or folder.

tf vc changeset      Displays information about a changeset and lets you
                     change the associated attributes, such as comments and
                     check-in notes.

tf vc checkin        Commits pending changes in the current workspace to TFVC.

tf vc checkout       Makes the local file writable and changes its pending
                     Change status to "edit" in the workspace. Edit is an
                     alias for the checkout command.

tf vc certificates   Configures how client authentication certificates are
                     used when connecting to Azure DevOps through a secure connection.

tf vc configure      Enables an administrator to view and change the following
                     configuration settings for a team project in the Source
                     Control Settings dialog box:
                     - Check-out settings
                     - Check-in policies
                     - Check-in notes

tf vc delete         Removes files and folders from TFVC
                     and deletes them from the disk.

tf vc destroy        Destroys, or permanently deletes, version-controlled
                     files from TFVC.

tf vc diff           Compares, and if it is possible, displays differences
                     between two files, files in two folders, or a shelveset
                     and a local or server file.

tf vc dir            Displays all or part of the contents of TFVC.

tf vc folderdiff     Display a visual representation of the differences between
                     files in two server folders, in a server folder and a
                     local folder, or in two local folders.

tf vc get            Retrieves a read-only copy of a file from Azure DevOps
                     Server to the workspace and creates folders on disk to
                     contain it.

tf vc history        Displays the revision history for one or more files and
                     folders.

tf vc info           Displays information about items under version control.

tf vc label          Attaches a label to or removes a label from a version of a
                     file or folder in TFVC.

tf vc labels         Displays the list of labels in TFVC.

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

tf vc lock           Locks or unlocks a file or folder to deny or restore the
                     permissions of users to check out an item for edit into
                     a different workspace or to check in pending changes to
                     an item from a different workspace.

tf vc merge          Applies changes from one branch into another.

tf vc merges         Displays detailed information about past merges between
                     the specified source and destination branches.

tf vc msdn           Displays the https://learn.microsoft.com documentation
                     page for the command.

tf vc permission     Modifies the user access control list (ACL) and displays
                     authorization settings for an item under version control.

tf vc property       Displays and pends changes on properties associated with
                     items under version control.

tf vc reconcile      Compares the current state of the workspace on disk with
                     the server's view, either to clean the workspace or to
                     promote unpended local changes.

tf vc rename         Changes the name or the path of a file or folder. You
                     can use the rename command or the alias Move to move a
                     file or folder to a new location.

tf vc resolve        Resolves conflicts between changed items in your
                     workspace and the latest or destination versions of items
                     on the server.

tf vc resolvePath    Resolves a server path to a local path in your workspace.

tf vc rollback       Rolls back the changes in a single or a range of
                     changesets.

tf vc shelve         Stores a set of pending changes, together with pending
                     check-in notes, a comment, and a list of associated work
                     items in Azure DevOps Server without actually checking
                     them into the version control server.

tf vc shelvesets     Displays information about a set of shelved changes.

tf vc status         Displays information about pending changes to items in
                     one or more workspaces.

tf vc undelete       Restores items that were previously deleted.

tf vc undo           Removes pending changes from a workspace.

tf vc unlabel        Removes an item from an existing label in Team Foundation
                     version control.

tf vc unshelve       Restores shelved file revisions, check-in notes, comments,
                     and work item associations to the current workspace or
                     removes an existing shelveset from the server.

tf vc view           Retrieves a specific version of a file to a temporary
                     folder on your computer and displays it.

tf vc workfold       Creates, modifies, or displays information about the
                     mappings between your workspace folders and the TFVC
                     folders.

tf vc workspace      Creates, deletes, displays, or modifies properties and
                     mappings associated with a workspace.

tf vc workspaces     Displays information about workspaces in the system and
                     updates cached information about a user name or computer
                     name change on Azure DevOps Server.

View help for the view command

The following example displays help information for the view command.

>tf view /help
Microsoft (R) TF - Team Foundation Version Control Tool, Version 16.171.31930.1
Copyright (c) Microsoft Corporation.  All rights reserved.

Retrieves a specific version of a file to a temporary folder on your computer
and displays it.

tf vc view [/collection:TeamProjectCollectionUrl]
           [/console] [/recursive] [/output:localfile]
           [/shelveset:shelvesetname[;owner]] [/noprompt] itemspec
           [/version:versionspec] [/login:username,[password]]

Versionspec:
    Date/Time         D"any .NET Framework-supported format"
                      or any of the date formats of the local machine
    Changeset number  Cnnnnnn
    Label             Llabelname
    Latest version    T
    Workspace         Wworkspacename;workspaceowner

View help for the workspace command

The following example displays information about syntax for the workspace command.

>tf workspace /help 
Microsoft (R) TF - Team Foundation Version Control Tool, Version 16.171.31930.1
Copyright (c) Microsoft Corporation.  All rights reserved.

Creates, deletes, displays, or modifies properties and mappings associated
with a workspace.

tf vc workspace /new [/noprompt] [/template:workspacename[;workspaceowner]]
                [/computer:computername] [/comment:("comment"|@commentfile)]
                [workspacename[;workspaceowner]]
                [/collection:TeamProjectCollectionUrl]
                [/permission:(Private|PublicLimited|Public)]
                [/location:(local|server)]
                [/filetime:(current|checkin)]
                [/login:username,[password]]

tf vc workspace /delete [/collection:TeamProjectCollectionUrl]
                workspacename[;workspaceowner]
                [/login:username,[password]]

tf vc workspace [/collection:TeamProjectCollectionUrl]
                [/comment:("comment"|@commentfile)]
                [/newname:workspacename] [workspacename[;workspaceowner]]
                [/newowner:ownername] [/computer:computername]
                [/permission:(Private|PublicLimited|Public)]
                [/location:(local|server)]
                [/filetime:(current|checkin)]
                [/login:username,[password]]

The following example displays the same information about syntax for the workspace command.

tf workspace /?