You must have a workspace before you can perform Team Foundation version control commands on your computer. Team Foundation stores information about your workspaces. This information includes:

• A list of all the files in your workspace.

• The version of each file.

• A list of the pending changes.

Because the server stores this information, other users who have the correct permissions can duplicate your working environment on their computers. However, they will not be able to see any pending changes. For more information, see Get Command.

Workspace mapping establishes a client-side working folder. This is where you put files and subfolders when you execute a Get operation.

You can add and remove workspace mappings for a workspace by managing your workspace in Team Foundation version control or by using the workfold command from the tf command-line utility. For more information see How to: Add and Remove a Working Folder in a Workspace or Workfold Command.

You can also provide cloak mappings. Cloak mappings prevent the retrieval of files and subfolders in the specified server folder when you execute the Get operation. You can establish workspace mappings manually in the Create Workspace dialog box during the workspace creation process. Otherwise, Team Foundation will create the workspace mappings automatically when you add files to version control. For more information, see Working with Version Control Workspaces.

You can decide to map only the immediate children of a version control folder to a local workspace. You can do this by providing an asterisk wild-card character when you specify the folder. Otherwise, by default all the children of the version control folder are recursively mapped to the local workspace.

Mapping only one level in a version control hierarchy can limit the number of items downloaded to the client computer. This provides faster download times and saves disk space on the client computer.

A single workspace can contain multiple team projects. For more information, see How to: Add and Remove a Working Folder in a Workspace. You might want to maintain multiple copies of source files pointing to different versions of files. This can be helpful if you are working on a new release but must be able to refer back to the source files from a previous release. Also, creating a dedicated test workspace on your computer is useful when you perform peer reviews of a team member's code.

Concepts