更新：2007 年 11 月
显示系统中工作区的相关信息并更新 Team Foundation 服务器上的用户名或计算机名称更改的相关缓存信息。
必需的权限
若要使用 workspaces 命令，您必须将“读”权限设置为“允许”。有关更多信息，请参见 Team Foundation Server 权限。
tf workspaces [/owner:ownername] [/computer:computername]
[/server:servername] [/format:(brief|detailed)]
[/updateUserName:oldUserName] [/updateComputerName:oldComputerName]
workspacename
tf workspaces /remove:(*|workspace1[,workspace2,...])
/server:(*|server)
参数
参数 |
说明 |
|---|---|
ownername |
向 /owner 选项提供值。指定“*”以匹配任何用户创建的工作区。 |
computername |
向 /computer 选项提供值。指定“*”以匹配任何计算机上的工作区。 |
servername |
向 /server 选项提供值。例如：TeamServer2。 |
workspacename |
指定要显示相关信息的工作区的名称。如果未指定 workspacename，则显示服务器中所有工作区的相关信息。也可以使用“*”通配符来显示服务器中所有工作区的相关信息。 |
oldUserName |
为 /updateUserName 选项提供旧用户名。 |
oldComputerName |
为 /updateComputerName 选项提供旧计算机名称。 |
选项 |
说明 |
|---|---|
/owner |
指定创建工作区的用户的名称。如果未指定所有者，则 Team Foundation 仅返回属于当前用户的工作区的相关信息。 |
/computer |
指定用以筛选服务器工作区列表的客户端计算机的名称。如果未指定计算机，则 Team Foundation 仅返回当前计算机上工作区的相关信息。 |
/server |
指定用于筛选所指定工作区列表的 Team Foundation Server 的名称。如果未提供 servername，则 Team Foundation 返回使用本地缓存文件的所有已知 Team Foundation 服务器上的工作区的相关信息。 |
/format |
指定工作区信息的格式。Brief 返回工作区信息，但不返回映射。Detailed 则同时返回工作区信息和映射。详细格式只能在指定了 /server 选项时使用。Brief 为默认值。 |
/updateUserName |
为网络用户名已更改的用户更新 Team Foundation 服务器上的安全标识信息。如果指定此选项，则还必须使用 /server 选项来指定一个服务器。 |
/updateComputerName |
指示 Team Foundation 更新其表格，以反映客户端计算机名称中的更改。如果指定此选项，则还必须使用 /server 选项来指定一个服务器。 |
/remove |
从客户端缓存移除指定服务器的指定工作区项。 |
备注
tf 命令行实用工具的 workspaces 命令显示属于指定用户的当前计算机上的工作区的相关信息，或显示与特定 Team Foundation Server 相关联的所有工作区的信息。对于每个工作区，Team Foundation 都显示名称、所有者、注释和计算机名称。使用详细输出，它还会显示工作区映射。除非您提供诸如所有者、计算机或工作区名称的筛选，否则 Team Foundation 将仅显示您已创建的工作区的相关信息。
有关如何编辑工作区属性的更多信息，请参见 Workspace 命令。
有关如何查找 tf 命令行实用工具的更多信息，请参见 Tf 命令行实用工具命令。
示例
下面的示例显示当前计算机上的当前用户的所有工作区列表。
c:\projects>tf workspaces
下面的示例显示服务器 teamserver2 上创建的所有计算机上所有用户的所有工作区列表。
c:\projects>tf workspaces /owner:* /computer:* /server:teamserver2.
下面的示例显示当前用户为服务器 teamserver2 创建的所有工作区的详细信息。
c:\projects>tf workspaces /computer:* /format:detailed /server:teamserver2
下面的示例显示详细信息，其中包括关于工作区“WS1”的工作区映射列表，该工作区属于当前用户并位于当前计算机上。
c:\projects>tf workspaces /format:detailed /server:teamserver2 WS1
下面的示例从服务器 teamserver2 的缓存中移除所有缓存的工作区。
c:\projects>tf workspaces /remove:* /server:teamserver2