工作区命令 (Team Foundation 版本控制)

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019 |TFS 2018

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

参数

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 服务器上为网络用户名已更改的用户汇报安全标识信息。 如果指定此选项,则还必须使用 /collection 选项指定项目集合。

/updateComputerName

指示 TFVC 更新其表以反映客户端计算机名称中的更改。 如果指定此选项,则还必须使用 /collection 选项指定项目集合。

/remove

从客户端缓存中删除指定项目集合的指定工作区条目。

/collection

指定项目集合。

/login

指定使用 Azure DevOps Server 对用户进行身份验证的用户名和密码。

备注

workspaces命令行实用工具的 tf 命令显示有关指定用户拥有的当前计算机上的工作区的信息,或与特定 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 的详细信息,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