Events
Mar 17, 11 PM - Mar 21, 11 PM
Join the meetup series to build scalable AI solutions based on real-world use cases with fellow developers and experts.
Register nowThis browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
The Team Foundation Version Control (TFVC) status
command, or its alias stat
, displays information about pending changes to files and folders and pending change candidates in one or more workspaces. When you use the /shelveset
option, the command displays information about pending changes in a shelveset.
Note
A pending change candidate is a file in the workspace's folder or subfolder that isn't added to version control. To view all pending changes candidates in Visual Studio, go to Team Explorer > Pending Changes > Excluded Changes, and then select Detected.
Category | Requirements |
---|---|
Permissions | Read permission for the source item and the Check out and Merge permissions for the target folder set to Allow. |
For more information, see Default TFVC permissions.
tf stat[us] itemspec [/collection:TeamProjectCollectionUrl]
[/login:username,[password]]
([/workspace:workspacename[;workspaceowner]]
| [/shelveset:shelvesetname[;shelvesetowner]])
[/format:(brief|detailed)] [/recursive][/user:(*|username)]
[/nodetect]
Argument
Description
/collection: <TeamProjectCollectionUrl>
When you use the /workspace
option, specifies the URL of the project collection that contains the workspace that contains the pending changes. For example: http://myserver:8080/tfs/DefaultCollection
.
If not specified, by default the project collection is presumed to be the one that contains the workspace that maps the current directory.
Ignored if you don't use the /workspace
option.
Note
See Remarks for the limitations of this option.
/format
Specifies how much detail to display about each pending change:
Brief
(default): Displays one line about each pending change that includes: file name, changes, whether the item is locked as indicated by an asterisk *, local path, and user if using the /collection
and /workspace
options. Some of the data might be truncated.Detailed
: Displays a full description of each pending change. In addition to the above information, this option displays more data such as date and time.<itemspec>
Specifies the items for which you want pending change data. For syntax, see Use Team Foundation version control commands. You can specify more than one itemspec
argument.
/login
Specifies the user account to use to run the command. See Use Team Foundation version control commands.
/recursive
Recursively retrieves data about pending changes to items in the specified directory and any subdirectories.
/shelveset:<shelvesetname>[;<shelvesetowner>]
Specifies the shelveset that contains the changes you want to list.
This option can't be combined with the /workspace
option.
/user
Lists all pending changes made by the specified user. An asterisk *
includes data about changes from all users. The default is the current user.
Acceptable values for this option:
<username>
<useraccount>
*
Note
See Remarks for the limitations of this option.
/workspace:<workspacename>[;<workspaceowner>]
Specifies the name of the workspace that contains the pending changes. If not specified, the workspace is the one that maps the current directory.
You can specify workspaceowner
to get data about pending changes in a workspace that belongs to a specific user. If not specified, the workspace is presumed to be the current user, or if specified, the /login:<username>
.
This option can't be combined with the /shelveset
option.
Note
See Remarks for the limitations of this option.
You can use the status
command to view pending changes in the current workspace, for example the workspace that maps the current directory, regardless of whether it's a local workspace or a server workspace. You can also use this command to view pending changes in a remote server workspace, for example changes made by another user on another dev machine, by using the /collection
, /user
, and /workspace
options. However, you can't view pending changes in a remote local workspace.
For more information, see Decide between using a local or a server workspace.
In all the following examples, assume that $/SiteApp/Main/ is mapped to c:\code\SiteApp\Main\ in the workspace.
The following example lists all pending changes in the workspace:
c:\code\SiteApp\Main\SolutionA\>tf stat
The following example lists all pending changes to all items in the SolutionA folder:
c:\code\SiteApp\Main>tf stat SolutionA\*
The following example lists pending changes to all items in the SolutionA folder, including changes in its subfolders:
c:\code\SiteApp\Main>tf stat SolutionA\* /recursive
Most changes you make to files under version control are queued as pending changes in your workspace. For more information, see Develop code and manage pending changes and Create and work with workspaces.
You can use the Difference command to get details about edit changes, or changes to the content, in a file.
If you need to set aside changes, and perhaps also want to clean your workspace for another task, use the Shelve command. For more information about shelvesets, see Suspend your work and manage your shelvesets.
When you're ready to check in changes to the server, use the Checkin command.
For more information about how to use the tf
utility, see Use Team Foundation version control commands
Events
Mar 17, 11 PM - Mar 21, 11 PM
Join the meetup series to build scalable AI solutions based on real-world use cases with fellow developers and experts.
Register now