Share via


Undo Command

Removes pending changes from a workspace.

Required Permissions

To use the undo command, you must be the owner of the specified workspace or have the global Administer workspaces permission set to Allow. For more information, see Team Foundation Server Permissions.

tf undo [/workspace:workspacename[;workspaceowner]] 
 [/recursive] itemspec [/noprompt] [/login:username, [password]] [/collection:TeamProjectCollectionUrl]

Parameters

Argument

Description

workspacename

The user-provided value for the /workspace option.

workspaceowner

Specifies the name of the user who created the workspace.

TeamProjectCollectionUrl

The URL of the team project collection that contains files from which you want to remove pending changes (for example, http://myserver:8080/tfs/DefaultCollection).

itemspec

Identifies the file or folder from which to remove pending changes. 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.

username

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

Option

Description

/workspace

Specifies the name of the workspace in which you want to undo pending changes. If this option is not specified and you are running the command from a directory that has been added to a workspace, the current workspace is used.

/recursive

Recursively undo changes according to the itemspec.

/noprompt

Suppresses any prompts for input from you.

/collection

Specifies the team project collection.

/login

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

Remarks

The undo command checks to see whether files that have pending edits being undone have been modified on disk. If modifications are detected, the undo command without /noprompt displays a prompt asking whether to continue with undoing the changes. You may respond with Yes, No, or All.

The undo command returns all checked-out files to a read-only, unmodified state. It discards all pending changes to files and folders and restores the items to the Team Foundation version control server version.

The undo command removes check-in and check-out locks so that other users can check out the file and make pending changes against it in their own workspaces.

If you use the undo command to undo a pending change on another user's computer, you must perform a get operation in that workspace to update the local disk. Not only must get be run, but you may have to run get /all for the files that were undone in order to download the correct content for files that were being edited.

For more information about how to obtain a list of pending changes in a workspace, see Status Command.

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

Examples

The following example removes all pending changes against 314.cs in the current workspace.

c:\projects>tf undo 314.cs

The following example removes all pending changes in the c:\projects folder and all its subfolders.

c:\projects>tf undo /recursive c:\projects

The following removes the pending change for the specified file in Ivan's WS_Juan workspace.

c:\projects>tf undo /workspace:WS_Juan;Ivan $/math/271.cs

See Also

Reference

Command-Line Syntax (Version Control)

Shelve Command

Undelete Command

Command-Line Options

Concepts

Pending Changes

Other Resources

Tf Command-Line Utility Commands