Workfold 命令（Team Foundation 版本控制）
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Team Foundation 版本控制 (TFVC) workfold 命令可创建、修改或显示有关工作区文件夹与适用于 TFVC 的 Azure DevOps Server 上的文件夹之间的映射的信息。
先决条件
要使用 workfold 命令，必须具有指定或隐含工作区的所有者身份，或者将全局“管理工作区”权限设置为“允许”。 有关详细信息，请参阅默认 TFVC 权限。
语法
tf workfold <local-folder> [/login:<username>,[<password>]]
tf workfold [/workspace:<workspace-name>] [/login:<username>,[<password>]]
tf workfold [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] [/login:<username>,[<password>]]
<server-folder>
tf workfold [/map <server-folder> <local-folder>] [/collection:<team-project-collection-url>]
[/workspace:<workspace-name>][/login:<username>,[<password>]
tf workfold /unmap [/collection:<team-project-collection-url>] [/workspace:<workspace-name>]
[/recursive] (<server-folder>|<local-folder>) [/login:<username>,[<password>]]
tf workfold /cloak
<server-folder> [/workspace:<workspace-name>] [/collection:<team-project-collection-url>] [/login:<username>,[<password>]]
tf workfold /decloak <server-folder>
[/workspace:<workspace-name>] [/collection:<team-project-collection-url>][/login:<username>,[<password>]]
参数
以下各部分介绍 workfold 命令的参数和选项。
参数
Argument
说明
<workspace-name>
使用 /workspace 选项指定命令操作的工作区的名称。
<server-folder>
指定 Azure DevOps 服务器文件夹的名称。
<local-folder>
指定本地文件夹的名称。
<team-project-collection-url>
包含要与服务器文件夹进行比较的文件夹的项目集合的 URL，例如 https://myserver:8080/tfs/DefaultCollection/。
<username>
为 /login 选项提供值。 可以将此值指定为 DOMAIN\<username> 或 <username>。
<password>
为 /login 选项提供值。
选项
选项
说明
/workspace
指定要在其中工作的工作区的名称。
/map
指定本地文件夹与 Azure DevOps 服务器文件夹之间的关联。 默认情况下，即使未指定，workfold 命令也会使用此选项，除非指定了 /unmap、/cloak 或 /decloak。
/unmap
指定要从工作区中移除的文件夹映射。
/cloak
指定应将文件夹从在工作区中执行的任何版本控制操作中排除。
/decloak
取消掩蔽文件夹，以便可以将文件夹检索到工作区中。
/collection
指定项目集合。
/login
指定用户名和密码，以便使用 Azure DevOps 对用户进行身份验证。
注解
可以使用 tf 命令行实用工具的 workfold 命令来创建和编辑工作区映射。 工作区映射创建客户端文件夹，运行操作时tfget，将检索 Azure DevOps 服务器文件夹中的所有文件和子文件夹。 如果掩蔽客户端文件夹，get 操作不起作用。
还可以使用星号 (*) 通配符将 Azure DevOps 服务器文件夹及其直接项映射到本地工作区。 此映射通常称为“单文件夹映射”。
有关如何使用 tf 命令行实用工具的详细信息，请参阅使用 Team Foundation 版本控制命令。
工作区映射选项
工作区映射是活动项和掩蔽项的列表。 可以使用 /map 选项将 Azure DevOps 服务器项添加到工作区中的映射列表。 还可以使用 /cloak 选项从工作区中显式排除项。 只能掩蔽具有映射父级的项。 掩蔽是提高批处理 get 操作速度和节省磁盘空间的有效方法。
请谨慎使用掩蔽。 为了避免编译和集成问题，只应掩蔽那些你知道不在当前和未来项目范围内的项，例如图像和外部文档文件。
可以使用 /unmap 和 /decloak 选项选择性地从工作区映射中删除映射和掩蔽的条目。
如何应用工作区映射
默认情况下，工作区映射以递归方式应用。 将本地文件夹映射到 Azure DevOps 服务器文件夹时，系统会在其所有当前和未来子文件夹之间隐式创建映射。
例如，假设将 $/projects 映射到 C:\projects。 接下来，添加名为 $/projects/project_one 的项目，然后在工作区上运行 get 命令。 在这种情况下，TFVC 会在 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 映射到 Azure DevOps 服务器文件夹 $/projects/project_one，并替换 $/projects/project_one Azure DevOps 服务器文件夹之前的工作区映射：
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold