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