Cloak and Uncloak Folders in a Workspace

Use cloaking to prevent users from viewing specified workspace folders or for folders you do not currently need. Cloaking is useful when you are working with files from two or more branches under a common parent to prevent you from copying files unnecessarily. Finally, cloaking increases performance bandwidth and conserves local disk space by preventing folders and files not used currently from being copied to the local working folder. For more information, see Create a Workspace to Work with your Team Project.

Although you can cloak an existing folder mapping in your workspace, a more common scenario is to create a new folder mapping that is specifically for cloaking. You cannot cloak a folder that already contains cloaked items. However, you can map items under a cloaked folder to the local workspace. For more information, see Add and Remove a Working Folder in a Workspace.

Required Permissions

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

To cloak folders in a workspace

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

  2. In the Manage Workspaces dialog box, click the workspace you want to cloak, and then click Edit.

  3. In the Edit Workspaces dialog box, in the Working folders list, either highlight the folder mapping located under Source Control Folder and Local Folder that you want to cloak, or create a new one. Under Status, change the setting from Active to Cloaked.

    Note

    You can only cloak folders in a mapped Team Foundation version control server folder.

  4. Click OK to close Edit Workspaces and then click Close to close Manage Workspaces.

    Note

    The files will not disappear locally until you perform a get operation for the whole workspace. For more information, see Update File Versions in Your Workspace.

To uncloak folders in a workspace

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

  2. In the Manage Workspaces dialog box, click the workspace you want to uncloak, and then click Edit.

  3. In the Edit Workspaces dialog box, in the Working folders list, perform one of the following steps:

    • Highlight the folder located under Source Control Folder and Local Folder that you want to uncloak. Under Status, change the setting from Cloaked to Active.

    • Highlight the applicable row that contains the cloaked folder and then click Remove. This action deletes the cloaked folder.

  4. Click OK to close Edit Workspaces, and then click Close to close Manage Workspaces.

    Note

    The files do not disappear locally until you perform another get operation for the whole workspace. For more information, see Update File Versions in Your Workspace.

See Also

Concepts

Create a Workspace to Work with your Team Project

Create and Work With Workspaces