Export (0) Print
Expand All
1 out of 1 rated this helpful - Rate this topic

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: 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 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.

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.

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

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.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.