How to: Create a Mapped Workspace

  • Article

Create a workspace so that you can perform Team Foundation version control commands on your computer. A workspace includes client-side folders on the local disk that are mapped to version-controlled folders on the Team Foundation version control server. For more information about how to create a workspace from the command-line, see How to: Create a Workspace from the Command-Line.

Note

To see all the workspaces you have already created for your account, use the tf workspaces command. For more information, see Workspaces Command.

The following procedures describe how to create a workspace for Team Foundation version controlled-items by using Source Control Explorer. 

Required Permissions

To perform these procedures, you must have the permissions for Create a workspace or Administer workspaces set to Allow. For more information, see Team Foundation Server Permissions.

To create a mapped workspace, perform the following procedures:

  • Creating a Local Workspace by Using the Manage Workspaces Dialog Box

  • Creating a Workspace by using the Map to Local Folder Option

Creating a Local Workspace by Using the Manage Workspaces Dialog Box

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

To create a workspace by using the Manage Workspaces dialog box

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

  2. In the Manage Workspaces dialog box, click Add.

  3. Type a descriptive name in the Name box, provide alternative Owner and Computer values as necessary, and then enter a comment describing the new workspace in the Comment box.

  4. Under Working Folders in the Source Control Folder column, click the text box, and then click the ellipsis (…).

  5. In the Browse for Folder dialog box, select a server folder, and then click OK.

    If you want to map the Team Foundation Server folder and only its immediate child items to the local workspace, you can also add /* to the Source Control Folder box. The asterisk (*) is a wildcard character.

    Note

    If you include an asterisk wildcard character, you only map one level under the folder (subfolder). If you do not include an asterisk, you recursively map all subfolders.

  6. In the Local Folder box, click the text box, and then click the ellipsis (…).

  7. In the Browse for Folder dialog box, select a folder on your computer, and then click OK.

  8. Click OK to create the workspace.

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

    The workspace name that you created now appears in the Workspace box on the Source Control Explorer toolbar.

    Local Path now contains a link to open the local folder that you created.

    Tip

    Once you establish a workspace, select the new workspace from the Workspace list on the Source Control Explorer toolbar, right-click the project folder that has the version-controlled files that you want to retrieve, and then use the Get Latest Version command to populate your workspace with versioned data from the server.

Creating a Workspace by using the Map to Local Folder Option

Use the following procedure to create 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 create a workspace by using the Map to Local Folder option

  1. In Source Control Explorer, right-click a folder that has not previously been mapped to a local folder, and then click Map to Local Folder.

    The Map dialog box appears.

  2. On the Map dialog box, in the Local folder box, type a valid path of the local folder. You can optionally click the ellipsis (…) to browse to a local folder or to create a new local folder.

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

  3. Click Map.

    A confirmation dialog box that has the text Newly mapped items will not be downloaded until you execute a get, Do you want to get<server folder path>now? is displayed.

  4. Click Yes to download the mapped items immediately, click No to download them later.

    The workspace name that you created now appears in the Workspace box on the Source Control Explorer toolbar.

    Local Path now contains a link to open the local folder you created.

See Also

Tasks

How to: Create a Workspace from the Command-Line

How to: Cloak and Uncloak Folders in a Workspace

Concepts

Working with Version Control Workspaces

Version Control Workspaces and Mapping

Working with Version Control Workspaces

Reference

Workspace Command

Workfold Command