Status Command

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

tf status itemspec [/server:servername] ([/workspace:workspacename[;workspaceowner]]
 | [/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.
servername	The user-provided value for the /server option. Example: https://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 user who created the shelveset.
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 in one or more workspaces. 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 Source 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.

Command Output

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

There are two modes of display: brief and detailed.

/Format:brief displays the item's server location, lock status and type, 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. The folder is omitted if items from only one folder are specified.

/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

Security

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.

See Also

Reference

Command-Line Syntax
Changeset Command
Shelvesets Command

Concepts

Working with Source Control Workspaces
Pending Changes
Working with Source Control Changesets
Working with Source Control Shelvesets
Informational Commands

Other Resources

Tf Command-Line Utility Commands
Comparing Files in Source Control