Workspaces 命令（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 Server 上用户名或计算机名更改的相关缓存信息。
先决条件
若要使用 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 命令的参数和选项。
参数
Argument
说明
<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 Server 上的安全标识信息。 如果指定此选项，还必须使用 /collection 选项指定项目集合。
/updateComputerName
指示 TFVC 更新其表，使之反映客户端计算机名称中的更改。 如果指定此选项，还必须使用 /collection 选项指定项目集合。
/remove
从客户端缓存中移除指定项目集合的指定工作区条目。
/collection
指定项目集合。
/login
指定用户名和密码，以便使用 Azure DevOps Server 对用户进行身份验证。
注解
tf 命令行实用工具的 workspaces 命令显示当前计算机上由指定用户拥有的工作区的相关信息，或与特定 Azure DevOps Server 关联的所有工作区的相关信息。 对于每个工作区，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 的相关详细信息，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