Friday, September 12, 2008

TFS Power Tools - Rollback Command

Visual Studio Team System 2008 Team Foundation Server Power Tools contains an Rollback Command(Rollback) Command.

Usage: tfpt rollback [/changeset:changesetnum] [/recursive]
[/noprompt [/automerge:(all|none)]] [filespec...]

/changeset Specifies the number of the changeset to roll back
/noprompt Operate in command-line mode only
filespec... Only files and directories in the changeset matching
these filespecs are processed

Options usable only in /noprompt mode:
/automerge Specify whether or not to try to automerge the edits
out of the specified changeset

Options usable only with filespecs:
/recursive Use full recursion instead of one-level for filespecs

According to the website, this command should be used to "Use the rollback command to roll back changes that have already been committed to Team Foundation Server."

The help menu from the command line offers a more complete description of the functionality: "Rollback does not actually remove a changeset from the server, but instead pends changes which attempt to return to the state before the offending changeset was checked in."

The rollback doesn't always allow you to rollback changes (for instance, you cannot rollback a changeset while you have any pending changes in your workspace), and you should be aware that it reverts the source back to it's state prior to the changeset.

To Execute a Rollback:

Using the command promput, naviagate to your local workspace folder, and type the following command:
C:\SourceCode\Memo>tfpt.exe rollback

This will bring up the GUI for the rollback.

If you want to execute the entire command from the commandline, you can execute the following:
C:\SourceCode\Memo>tfpt.exe rollback /changeset [ChangeSet#]

If you need additional help building your rollback command, there is always help from the commandline:
C:\SourceCode\Memo>tfpt.exe rollback /help

No comments: