This documentation is archived and is not being maintained.

How to: Modify a Workspace

A workspace includes a client-side working folder on the local disk mapped to a version-controlled folder on the Team Foundation version control server. You can modify the mappings and change the client-side working folder. You can modify a workspace mapping in Team Foundation, or from the command line using the Workspace Command.

The following procedure demonstrates how to modify a Team Foundation workspace from your computer.

Required Permissions

To perform these procedures, you must either own the workspace, or have the Administer workspaces permission set to Allow. For more information, see Team Foundation Server Permissions.

To create a mapped workspace, perform the following procedures:

Use the Edit Workspace dialog box to create a local workspace by using either the Team Foundation Server 2008 or the Service Pack 1 edition of Team Foundation Server 2008.

To modify a workspace by using Source Control Explorer

  1. From the File menu, click Source Control, and then click Workspaces.

  2. In the Manage Workspaces dialog box, under the Name column, highlight the workspace that you want to modify, and then click Edit.

  3. In the Edit Workspace dialog box:

    1. Modify the name in the Name box.


      The computer name value is non-mutable. If a computer name changes, run tf workspaces /updatecomputername from the tf command-line utility. Otherwise, workspaces cannot move from one computer to another. For more information, see Workspaces Command.

    2. In the Comment box, enter a comment that describes the modifications that you made to the workspace.

    3. Modify the working folders.

    4. Click OK to save the workspace changes.


    Once the workspace is established, you must now populate your workspace with files from the server. For more information, see Get Command.

  4. In the Manage Workspaces dialog box, click Close.

Use the following procedure to modify a local workspace by using the Service Pack 1 edition of Team Foundation Server 2008 and Team Explorer.

Important noteImportant Note:

This functionality is only available with the Service Pack 1 edition of Team Foundation Server 2008.

To modify a workspace by using the Remove Mapping option

  1. In Source Control Explorer, right-click a mapped folder, and then click Remove Mapping.

  2. In the Remove Mapping dialog box, modify the path in the Local folder box, or click the ellipsis () to browse to a new local folder.

    If you want to map the Team Foundation Server folder and only its immediate child items for the local workspace, clear the Recursive box.

  3. Click Change to update the mappings to the new local folder.