Find, View and Delete Shelvesets (Team Explorer Everywhere)

  • Article

You can use shelvesets when you want to temporarily set aside your pending changes. For example, you might create a shelveset when you must fix a high-priority bug in the code that you were working on or when you want to share your code for other team members to review. You can find a shelveset to examine its details, unshelve it, or even delete it. When you unshelve a shelveset, you restore the changes from it into your local workspace. You typically delete a changeset only after you have checked in the changes to version control.

In this topic

  • Find a Shelveset

  • View Details for Shelvesets

  • Delete a Shelveset

Required Permissions

To find or view a shelveset, your Read permission on at least one item in that shelveset must be set to Allow. To delete a shelveset, you must own it or your Administer workspaces permission must be set to Allow. For more information, see the following page on the Microsoft Web site: Team Foundation Server Permissions.

Find a Shelveset

To find a shelveset from the Pending Changes window

  1. In the Pending Changes window, click Unshelve.

    The Unshelve dialog box appears.

  2. In Owner, type the name or alias of a member of the project team, and then click Find.

    The Results list displays all shelvesets that are owned by the person whom you specified. For information about actions that you can take on a shelveset, see View Details for Shelvesets, Delete a Shelveset, and Shelve and Unshelve Pending Changes (Team Explorer Everywhere).

To find a shelveset from a Command Prompt window

  1. Open a Command Prompt window.

  2. At the command prompt, type tf shelvesets, and then press ENTER.

    For more information, see the following page on the Microsoft Web site: Shelvesets Command (Team Foundation Version Control).

View Details for Shelvesets

You can view the following information about any shelveset in Team Foundation version control:

  • The name of the shelveset

  • The name of the person who created and owns the shelveset

  • The date and time at which the shelveset was created

  • The list of files in the shelveset and the pending changes to each file

  • A list of any work items that are associated with the shelveset

  • Any check-in notes that are associated with the shelveset

To view details for a shelveset

  1. Find the shelveset for which you want to view details.

    For more information, see Find a Shelveset.

  2. In the Results list, click the shelveset for which you want to view details, and then click Details.

    The Shelveset Details dialog box appears and lists the files in the shelveset.

  3. (Optional.) Perform one or more of the following tasks:

    • To view details about the shelveset, click Source Files, Work Items, or Check-in Notes.

    • To view file contents, right-click the file that you want to view, point to View, and then click View Shelved Change, View Unmodified Version, or View Latest Version.

    • To compare file contents, right-click the file that you want to compare, point to Compare, and then click either Compare with Unmodified Version or Compare with Latest Version.

    • To view file properties, right-click the file whose properties you want to view, and then click Properties.

    You can also unshelve the changes. For more information, see Unshelve Pending Changes.

  4. Click Close after you finish viewing shelveset details.

To view details for a shelveset from a command prompt

  1. Open a Command Prompt window.

  2. At the command prompt, type tf shelvesets –format:detailed ShelvesetName, and then press ENTER. Replace ShelvesetName with the name of the shelveset whose details you want to view.

    For more information, see the following page on the Microsoft Web site: Shelvesets Command (Team Foundation Version Control)

Delete a Shelveset

You can delete a shelveset manually, as the following procedure describes, or by unshelving it from within the Shelveset Details dialog box. For more information about the unshelve operation, see Unshelve Pending Changes.

To delete a shelveset

  1. In the Pending Changes window, click Unshelve.

    The Unshelve dialog box appears.

  2. Find the shelveset that you want to delete.

    For more information, see Find a Shelveset.

  3. In the Results list, click the shelveset that you want to delete, and then click Delete.

  4. In the confirmation dialog box, click Yes.

    The deleted shelveset no longer appears in the Results list.

To delete a shelveset from a command prompt

  1. Open a Command Prompt window.

  2. At the command prompt, type tf shelve –delete ShelvesetName, and then press ENTER. Replace ShelvesetName with the name of the shelveset that you want to delete.

    For more information, see the following page on the Microsoft Web site: Shelve Command (Team Foundation Version Control)

  3. When prompted, confirm that you want to delete the shelveset.

See Also

Tasks

Shelve and Unshelve Pending Changes (Team Explorer Everywhere)

Other Resources

Working with Changesets (Team Explorer Everywhere)

Using Shelvesets to Set Aside Pending Changes (Team Explorer Everywhere)