How to create a mapped workspace in TFS

Create a workspace to perform Team Foundation versioning commands on your computer. The workspace includes client 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 Workspaces from the command line.

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

The following procedure describes how to use Source Control Explorer to create workspaces for Team Foundation versioning-guided items.

Required Permissions

To perform these procedures, you must have the Create workspace or Manage Workspaces permission set to allow. For more information, see Team Foundation Server permissions.

To create a mapped workspace, follow these procedures:

To create a local workspace by using the Manage Workspaces dialog box

Create a workspace using the map to local folder option create a local workspace using the Manage Workspaces dialog box

With Team Foundation Server 2008 or Service Pack 1 version of Team Foundation Server 2008, use the Manage Workspaces dialog box to create a local workspace. To create a workspace by using the Manage Workspaces dialog box

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

In the Manage Workspaces dialog box, click Add.

Type a descriptive name in the name box, provide alternate owner and computer values as needed, and then enter a comment in the comment box that describes the new workspace.

Under Working folders, in the Source Control folder column, click the text box, and then click the ellipsis (...).

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

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

Description
If you include the asterisk wildcard, only the first level (subfolders) below the folder will be mapped. If you do not include an asterisk, all subfolders are mapped recursively.

In the Local folder box, click the text box, and then click the ellipsis (...).

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

Click OK to create the workspace.

In the Manage Workspaces dialog box, click Close.

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

The local path now contains a link to open the local folder you created.

Tips:
After you create the workspace, select the new workspace from the workspace list on the Source Control Explorer toolbar, right-click the project folder that contains the version-controlled files that you want to retrieve, and then use the Get Latest Version command to populate your workspace with versioned data on the server.

Create a workspace using the map to local folder option

Using the Service Pack 1 version of Team Foundation Server 2008 and Team Explorer, use the following procedure to create a local workspace.

Important NOTES:
Only the Service Pack 1 version of Team Foundation Server 2008 provides this functionality.

Create a workspace using the map to local folder option

In Source Control Explorer, right-click a folder that was not previously mapped to a local folder, and then select Map to local folder.

The Map dialog box appears.

In the Mappings dialog box, in the Local folder box, type a valid path for the local folder. You can also click the ellipsis (...) to browse to a local folder or create a new local folder.

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

Click Mappings.

A confirmation dialog box is displayed that contains the text "new mapped items will not be downloaded until the fetch operation is performed." Do you want to get the < server folder path now?.

Click Yes to download the mapped item now, and click No to download the mapped item later.

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

The local path now contains a link to open the local folder you created.