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
See Also
Concepts
Working with Version Control Workspaces
Working with Version Control Changesets
Working with Version Control Shelvesets
Reference
Command-Line Syntax (Team System)