Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.
This topic has not yet been rated - Rate this topic

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 [/collection:TeamProjectCollectionUrl] [/login:username,[password]] ([/workspace:workspacename[;workspaceowner]]|[/shelveset:shelvesetname[;shelvesetowner]])[/format:(brief|detailed)] 
[/recursive][/user:(*|username)] 

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 (Version Control).

NoteNote
You can specify more than one Itemspec argument.

TeamProjectCollectionUrl

The URL of the team project collection about which you want to show status information (for example, http://myserver:8080/tfs/DefaultCollection).

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

/collection

Identifies the team project collection.

/login

Specifies the user name and password to authenticate the user with Visual Studio Team Foundation Server.

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

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 of the collection that is located at http://myserver:8080/tfs/DefaultCollection/.

c:\projects>tf status /collection: http://myserver:8080/tfs/DefaultCollection/ /workspace:*

The following example displays information about all changes that Joe has made but has not checked in, in all workspaces of the collection that is located at http://myserver:8080/tfs/DefaultCollection/.

c:\projects>tf status /collection: http://myserver:8080/tfs/DefaultCollection/ /workspace:* /user:Joe
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft. All rights reserved.