Status Command

Status Command

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

Visual Studio Team System

Status Command

Displays information about pending changes to items in one or more workspaces.

Required Permissions

To use the status command, you must have the Read permission set to Allow for all specified files or folders. For more information, see Team Foundation Server Permissions.

tf status itemspec [/server:servername] [/workspace:workspacename[;workspaceowner]] [/format:(brief|detailed)] 
[/recursive] [/user:(*|username)]

tf status itemspec [/server:servername] [/shelveset:shelvesetname[;shelvesetowner]] [/format:(brief|detailed)] 
[/recursive] [/user:(*|username)]

Parameters

Argument	Description
itemspec	Identifies the file or folder for which to display status details. For more information about how Team Foundation parses itemspecs to determine which items are within scope, see Command-Line Syntax (Team System).
servername	The user-provided value for the /server option. Example: http://teamfoundation2:8080.
workspacename	The user-provided value for the /workspace option.
workspaceowner	Specifies the name of the user who created the workspace.
shelvesetname	The user-provided value for the /shelveset option.
shelvesetowner	Specifies the name of the shelveset owner.
username	Provides a value to the /user option. A username value can be expressed in one of two ways, depending on the network settings: DOMAIN\username or username.

Option	Description
/server	Identifies the Team Foundation Server. This option is required if the command is invoked from a directory that is not mapped to a workspace.
/workspace	Specifies the name of the workspace for which you want to see a list of changes. If this option is not specified and you are running the command from a directory that has been added to a workspace, the current workspace is used. This option cannot be combined with the /shelveset option.
/shelveset	The name of the shelveset for which you want to see a list of changes. This option cannot be combined with the /workspace option.
/format	The format of the status information. Brief displays a list of changes and changes that have been made to them pending check-in. Detailed displays complete status information. Brief is the default value.
/recursive	Shows status information for all items in the particular directory and any subdirectories.
/user	Filters the list of changes to the named user. An asterisk (*) can be used to represent all users. The default is the current user.

Remarks

You can use the status command to display a list of pending changes. A pending change is a file or folder revision that has not been submitted to the server and bundled into a versioned changeset. For more information, see Pending Changes.

You can also specify the /shelveset option to display details about the shelved, non-versioned changes of which a shelveset consists. For more information about the difference between pending changes and shelved changes, see Working with Version Control Shelvesets.

For links to other Team Foundation commands that provide additional information about the items on the server and all the workspaces that map to it, see Informational Commands.

For more information on how to find the tf command-line utility, see Tf Command-Line Utility Commands.

Command Output

If the pending change type is rename, the new name is displayed. For more information, see Rename Command (Team Foundation Version Control).

There are two modes of display: brief and detailed.

/Format:brief displays the item's file name, change and local path, if the item is locked, the type of pending change it represents, the user who made the change, and the location of the workspace version of the item on disk. The output is sorted first by folder, and then by file name in the folder.

/Format:detailed displays several lines of information about each pending change in the output. The detailed output includes everything that the brief output includes and adds date, time, and other information.

Examples

The following example displays information about all pending changes for the current user in the current workspace. The current workspace is the workspace to which the local directory is mapped.

c:\projects>tf status

The following example displays all pending changes for the current user under d:\src on the current computer.

c:\projects>tf status /recursive d:\src

The following example displays all pending changes for the current user in the Beta1 workspace.

c:\projects>tf status /workspace:Beta1

The following example displays status information for all pending changes for the user Jason.

c:\projects>tf status /user:Jason

The following example displays status information for all pending changes for all users, in all workspaces on the server.

c:\projects>tf status /user:*

The following example displays information about all pending changes for the current user in all workspaces on the server that is located on teamserver2.

c:\projects>tf status /server:teamserver2 /workspace:*

The following example displays information about all changes that Joe has made but has not checked in, in all workspaces that map to the teamserver2 server.

c:\projects>tf status /server:teamserver2 /workspace:* /user:joe

Command Output

Concepts

Reference

Other Resources