工作区命令 （Team Foundation 版本控制）
Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 |Visual Studio 2022
Team Foundation 版本控制（TFVC）workspaces 命令显示有关系统中工作区的信息，并更新有关 Azure DevOps 服务器上用户名或计算机名称更改的缓存信息。
先决条件
若要使用 workspaces 命令，请将 读取 权限设置为 “允许”。 有关详细信息，请参阅 默认 TFVC 权限。
语法
tf workspaces [/owner:<owner-name>] [/computer:<computer-name>]
[/collection:<team-project-collection-url>] [/format:(brief|detailed|xml)]
[/updateUserName:<old-user-name>] [/updateComputerName:<old-computer-name>]
[<workspace-name>][/login:<username>,[<password>]]
tf workspaces /remove:(*|workspace1[,workspace2,...])
/collection:(*|<team-project-collection-url>)
参数
以下部分介绍 workspaces 命令的参数和选项。
参数
参数
说明
<owner-name>
为 /owner 选项提供值。 使用空字符串（“”）匹配由任何用户创建的工作区。
<computer-name>
为 /computer 选项提供值。 使用空字符串（“”）匹配任何计算机上的工作区。
<workspace-name>
指定要显示其相关信息的工作区的名称。 如果未指定值，则会显示有关服务器中所有工作区的信息。 还可以使用星号 \ 通配符显示有关服务器的所有工作区的信息。
<old-user-name>
提供 /updateUserName 选项的旧用户名。
<old-computer-name>
提供 /updateComputerName 选项的旧计算机名称。
<team-project-collection-url>
包含要显示信息的工作区的项目集合的 URL，例如 https://myserver:8080/tfs/DefaultCollection。
<username>
为 /login 选项提供值。 可以将此值指定为 DOMAIN\<username> 或 <username>。
<password>
为 /login 选项提供值。
选项
选项
说明
/owner
指定创建工作区的用户的名称。 如果未指定所有者，则 TFVC 仅返回当前用户拥有的工作区的相关信息。
/computer
指定要筛选服务器工作区列表的客户端计算机的名称。 如果未指定计算机，则 TFVC 仅返回有关当前计算机上的工作区的信息。
/format
指定工作区信息的格式。
Brief 返回不带映射的工作区信息。
Detailed 返回工作区信息和映射。
Xml 返回工作区信息、映射、最新访问日期以及所有者别名。 仅当指定 /collection 选项时，才能使用详细格式。
Brief 是默认值。
/updateUserName
为已更改网络用户名的用户更新 Azure DevOps 服务器上的安全标识信息。 如果指定此选项，则还必须使用 /collection 选项指定项目集合。
/updateComputerName
指示 TFVC 更新其表，以反映客户端计算机名称的更改。 如果指定此选项，则还必须使用 /collection 选项指定项目集合。
/remove
从客户端缓存中删除指定项目集合的指定工作区条目。
/collection
指定项目集合。
/login
指定使用 Azure DevOps Server 对用户进行身份验证的用户名和密码。
言论
tf 命令行实用工具的 workspaces 命令显示有关当前计算机上 工作区、指定用户拥有或与特定 Azure DevOps 服务器关联的所有工作区的信息。 对于每个工作区，TFVC 显示名称、所有者、注释和计算机名称。 通过详细的输出，它还显示工作区映射。 除非提供筛选器（如所有者、计算机或工作区名称），否则 TFVC 仅显示有关已创建的工作区的信息。
有关如何编辑工作区属性的详细信息，请参阅 Workspace 命令。
有关如何使用 tf 命令行实用工具的详细信息，请参阅 使用 Team Foundation 版本控制命令。
例子
以下示例显示当前计算机上当前用户的所有工作区的列表：
c:\projects>tf workspaces
以下示例显示地址 https://myserver:8080/tfs/DefaultCollection在以下项目集合中创建的所有计算机上的所有用户的所有工作区的列表：
c:\projects>tf workspaces /owner:* /computer:* /collection:https://myserver:8080/tfs/DefaultCollection
以下示例显示有关当前用户在地址 https://myserver:8080/tfs/DefaultCollection的项目集合中创建的所有工作区的详细信息：
c:\projects>tf workspaces /computer:* /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection
以下示例显示有关当前用户拥有且位于当前计算机上的工作区 WS1的详细信息。 显示的信息包括工作区映射的列表。
c:\projects>tf workspaces /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection WS1
以下示例从地址 https://myserver:8080/tfs/DefaultCollection的项目集合中的缓存中删除所有缓存工作区：
c:\projects>tf workspaces /remove:* /collection:https://myserver:8080/tfs/DefaultCollection