Workspaces command (Team Foundation Version Control)

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

Visual Studio 2019 | Visual Studio 2022

The Team Foundation Version Control (TFVC) workspaces command displays information about workspaces in the system and updates cached information about a username or computer name change on an Azure DevOps server.

Prerequisites

To use the workspaces command, you must have the Read permission set to Allow. For more information, see Default TFVC permissions.

Syntax

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>)

Parameters

The following sections describe arguments and options of the workspaces command.

Arguments

Argument

Description

<owner-name>

Provides a value to the /owner option. Use an empty string ("") to match workspaces created by any user.

<computer-name>

Provides a value to the /computer option. Use an empty string ("") to match workspaces on any computer.

<workspace-name>

Specifies the name of a workspace to display information about. If a value isn't specified, information is displayed about all the workspaces in a server. You can also use an asterisk (*) wildcard character to display information about all workspaces for a server.

<old-user-name>

Provides the old username for the /updateUserName option.

<old-computer-name>

Provides the old computer name for the /updateComputerName option.

<team-project-collection-url>

The URL of the project collection that contains the workspaces about which you want to display information, for example, https://myserver:8080/tfs/DefaultCollection.

<username>

Provides a value to the /login option. You can specify this value as either DOMAIN\<username> or <username>.

<password>

Provides a value to the /login option.

Options

Option

Description

/owner

Specifies the name of the user who created the workspace. If no owner is specified, TFVC returns information about workspaces owned by the current user only.

/computer

Specifies the name of a client computer by which to filter the list of workspaces for the server. If no computer is specified, TFVC returns information about workspaces on the current computer only.

/format

Specifies the format of the workspace information. Brief returns workspace information without mappings. Detailed returns workspace information and also the mappings. Xml returns workspace information, a mapping, the latest access date, and also the owner aliases. The detailed format can only be used when the /collection option is specified. Brief is the default value.

/updateUserName

Updates security identification information on the Azure DevOps server for a user whose network username has been changed. If you specify this option, you must also specify a project collection by using the /collection option.

/updateComputerName

Instructs TFVC to update its tables to reflect a change in the name of a client computer. If you specify this option, you must also specify a project collection by using the /collection option.

/remove

Removes the specified workspace entries for the specified project collection from the client cache.

/collection

Specifies the project collection.

/login

Specifies the username and password to authenticate the user with Azure DevOps Server.

Remarks

The workspaces command of the tf command-line utility displays information about workspaces on the current computer, owned by a specified user, or for all workspaces associated with a specific Azure DevOps server. For each workspace, TFVC displays the name, owner, comment, and computer name. With detailed output, it also shows the workspace mappings. Unless you provide a filter such as the owner, computer, or workspace name, TFVC only displays information about the workspaces that you've created.

For more information about how to edit workspace properties, see Workspace command.

For more information about how to use the tf command-line utility, see Use Team Foundation version control commands.

Examples

The following example displays a list of all workspaces for the current user on the current computer:

c:\projects>tf workspaces

The following example displays a list of all workspaces for all users on all computers that have been created in the following project collection at the address https://myserver:8080/tfs/DefaultCollection:

c:\projects>tf workspaces /owner:* /computer:* /collection:https://myserver:8080/tfs/DefaultCollection

The following example displays detailed information about all workspaces that the current user has created in the project collection at the address https://myserver:8080/tfs/DefaultCollection:

c:\projects>tf workspaces /computer:* /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection

The following example displays detailed information about the workspace WS1, which is owned by the current user and is located on the current computer. The displayed information includes a list of workspace mappings.

c:\projects>tf workspaces /format:detailed /collection:https://myserver:8080/tfs/DefaultCollection WS1

The following example removes all cached workspaces from the cache in the project collection at the address https://myserver:8080/tfs/DefaultCollection:

c:\projects>tf workspaces /remove:* /collection:https://myserver:8080/tfs/DefaultCollection