Workspaces 命令
显示系统中工作区的相关信息并更新运行 Visual Studio Team Foundation Server 的服务器上的用户名或计算机名称更改的相关缓存信息。
所需权限
若要使用 workspaces 命令，您必须将**“读”权限设置为“允许”**。 有关更多信息，请参见 Team Foundation Server 权限。
tf workspaces [/owner:ownername] [/computer:computername]
[/collection:TeamProjectCollectionUrl] [/format:(brief|detailed)]
[/updateUserName:oldUserName] [/updateComputerName:oldComputerName]
[workspacename][/login:username,[password]]
tf workspaces /remove:(*|workspace1[,workspace2,...])
/collection:(*|TeamProjectCollectionUrl)
参数
参数 |
说明 |
|---|---|
ownername |
向 /owner 选项提供值。 指定“*”以匹配任何用户创建的工作区。 |
computername |
向 /computer 选项提供值。 指定“*”以匹配任何计算机上的工作区。 |
workspacename |
指定要显示相关信息的工作区的名称。 如果未指定 workspacename，则显示服务器中所有工作区的相关信息。 也可以使用“*”通配符来显示服务器中所有工作区的相关信息。 |
oldUserName |
为 /updateUserName 选项提供旧用户名。 |
oldComputerName |
为 /updateComputerName 选项提供旧计算机名称。 |
TeamProjectCollectionUrl |
您要显示其信息的工作区所在的团队项目集合的 URL（例如，http://myserver:8080/tfs/DefaultCollection）。 |
username |
向 /login 选项提供值。 可以按域\用户名或用户名的格式指定用户名值。 |
选项 |
说明 |
|---|---|
/owner |
指定创建工作区的用户的名称。 如果未指定所有者，则 Team Foundation 仅返回属于当前用户的工作区的相关信息。 |
/computer |
指定用以筛选服务器工作区列表的客户端计算机的名称。 如果未指定计算机，则 Team Foundation 仅返回当前计算机上工作区的相关信息。 |
/format |
指定工作区信息的格式。 Brief 返回工作区信息，但不返回映射。 Detailed 则同时返回工作区信息和映射。 详细格式只能在指定了 /collection 选项时使用。 Brief 为默认值。 |
/updateUserName |
为网络用户名已更改的用户更新 Team Foundation 服务器上的安全标识信息。 如果指定此选项，则还必须使用 /collection 选项来指定一个团队项目集合。 |
/updateComputerName |
指示 Team Foundation 更新其表格，以反映客户端计算机名称中的更改。 如果指定此选项，则还必须使用 /collection 选项来指定一个团队项目集合。 |
/remove |
从客户端缓存移除指定团队项目集合的指定工作区项。 |
/collection |
指定团队项目集合。 |
/login |
指定用于在 Team Foundation Server 中验证用户身份的用户名和密码。 |
备注
tf 命令行实用工具的 workspaces 命令显示属于指定用户的当前计算机上的工作区的相关信息，或显示与特定 Team Foundation Server 相关联的所有工作区的信息。 对于每个工作区，Team Foundation 都显示名称、所有者、注释和计算机名称。 使用详细输出，它还会显示工作区映射。 除非您提供诸如所有者、计算机或工作区名称的筛选，否则 Team Foundation 将仅显示您已创建的工作区的相关信息。
有关如何编辑工作区属性的更多信息，请参见 Workspace 命令。
有关如何查找 tf 命令行实用工具的更多信息，请参见 Tf 命令行实用工具命令。
示例
下面的示例显示当前计算机上的当前用户的所有工作区列表。
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