Workfold 命令
创建、修改或显示有关您的工作区文件夹和 Team Foundation 版本控制 服务器文件夹之间的映射的信息。
所需权限
若要使用 workfold 命令，您必须是指定的或隐含的工作区的所有者或者将全局**“管理工作区”权限设置为“允许”**。 有关更多信息，请参见 Team Foundation Server 权限。
tf workfold localfolder [/login:username,[password]]
tf workfold [/workspace:workspacename] [/login:username,[password]]
tf workfold [/collection:TeamProjectCollectionUrl] [/workspace:workspacename] [/login:username,[password]]
serverfolder
tf workfold [/map serverfolder localfolder] [/collection:TeamProjectCollectionUrl]
[/workspace:workspacename][/login:username,[password]
tf workfold /unmap [/collection:TeamProjectCollectionUrl] [/workspace:workspacename]
[/recursive] (serverfolder|localfolder) [/login:username,[password]]
tf workfold /cloak
serverfolder [/workspace:workspacename] [/collection:TeamProjectCollectionUrl] [/login:username,[password]]
tf workfold /decloak serverfolder
[/workspace:workspacename] [/collection:TeamProjectCollectionUrl][/login:username,[password]]
参数
参数 |
说明 |
|---|---|
workspacename |
为 /workspace 选项指定将运行命令的工作区的名称。 |
serverfolder |
指定 Team Foundation 版本控制 服务器文件夹的名称。 |
localfolder |
指定本地文件夹的名称。 |
TeamProjectCollectionUrl |
您要与服务器文件夹比较的文件夹所在的团队项目集合的 URL（例如，http://myserver:8080/tfs/DefaultCollection/）。 |
用户名 |
向 /login 选项提供值。 可以按域\用户名或用户名的格式指定用户名值。 |
选项 |
说明 |
|---|---|
/workspace |
指定要使用的工作区的名称。 |
/map |
在本地文件夹和 Team Foundation 版本控制 服务器文件夹之间指定关联。 默认情况下，workfold 命令将使用该选项（即使未指定也是如此），除非指定了 /unmap、/cloak 或 /decloak。 |
/unmap |
指定应当从工作区中移除哪个文件夹映射。 |
/cloak |
指定应当从工作区中所执行的任何版本控制操作中排除该文件夹。 |
/decloak |
取消掩蔽某个文件夹，以便可以将该文件夹检索到工作区中。 |
/collection |
指定团队项目集合。 |
/login |
指定用于在 Visual Studio Team Foundation Server 中验证用户身份的用户名和密码。 |
备注
可以使用 tf 命令行实用工具的 workfold 命令来创建和编辑工作区映射。 工作区映射功能将创建一个客户端文件夹，在执行 tf get 操作时，会将 Team Foundation 版本控制服务器文件夹中的所有文件和子文件夹检索到这个客户端文件夹中。 如果客户端文件夹已被掩蔽，此 get 将不起作用。
还可以指定星号 (*) 通配符来将 Team Foundation Server 文件夹及其直属项映射到本地工作区。 这通常称为单文件夹映射。
有关如何查找 tf 命令行实用工具的更多信息，请参见 Tf 命令行实用工具命令。
工作区映射选项
工作区映射是一个由活动项和掩蔽项组成的列表。 可以使用 /map 选项将 Team Foundation 版本控制 服务器项添加到工作区中的映射列表。 还可以通过使用 /cloak 选项将一个项从工作区中显式排除。 只能掩蔽拥有映射父级的项。 掩蔽是一种可以提高批处理“获取”(Get) 操作速度并节省磁盘空间的有效方法，
但应谨慎使用。 为了避免编译和集成问题，应该只掩蔽您所了解的当前和将来项目范围之外的项，例如，图像和外部文档文件。
可以使用 /unmap 和 /decloak 选项从工作区映射中有选择地删除映射项和掩蔽项。
如何应用工作区映射
默认情况下，工作区映射是递归应用的。 在将本地文件夹映射到 Team Foundation 版本控制服务器文件夹时，系统将在其所有当前和将来的子文件夹之间隐式创建映射。 例如，如果将 $/projects 映射到 c:\projects，后来添加一个名为 $/projects/project_one 的项目，然后对该工作区运行 get 命令，Team Foundation 将自动在 C:\projects 目录中创建一个名为 project_one 的本地工作文件夹。
在该示例中，可以使用“*”通配符来将服务器文件夹及其直属项映射到本地工作区：
tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject
在本示例中，可以按如下所示的方法，通过使用 workfold 命令来重写 $/projects/project_one 和 C:\projects\project_one 之间自动创建的映射：
tf workfold $/projects/project_one C:\DifferentWorkfold
映射掩蔽项下的内容
位于版本控制层次结构中某个掩蔽文件夹下的未掩蔽的文件夹可以映射到本地工作区。
示例
下面的示例显示 c:\projects 所驻留的工作区的映射。
c:\projects>tf workfold
下面的示例掩蔽 c:\projects\lib 文件夹。
c:\projects>tf workfold /cloak c:\projects\lib
下面的示例显示本地文件 word.cs 的映射。
c:\projects>tf workfold word.cs
下面的示例将文件夹 C:\DifferentWorkfold 映射到 Team Foundation 版本控制服务器文件夹 $/projects/project_one，并替换 $/projects/project_one Team Foundation 版本控制服务器文件夹以前的工作区映射。
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold