Properties Command

VSTS | TFS 2018 | TFS 2017 | TFS 2015 | VS 2017 | VS 2015 | VS 2013

Displays information about items under version control.

Required Permissions

To use the properties command, you must have the Read permission set to Allow for all specified files and folders. For more information, see Permissions and groups reference.

tf properties [/collection:TeamProjectCollectionUrl] [/recursive] [/login:username,[password]]
itemspec [/version:versionspec] [/workspace] 





The URL of the team project collection that contains the items for which you want to display properties (for example, http://myserver:8080/tfs/DefaultCollection).


Identifies the files and folders that are specified for property retrieval.

For more information about how Visual Studio Team Foundation Server parses itemspecs to determine which items are within scope, see Command-Line Options.

Note: You can specify more than one Itemspec argument.


Provides a value such as C3 for the /version option. For more information about how Team Foundation Server parses a version specification to determine which items are within its scope, see Command-Line Syntax (Version Control).


Provides a value to the /login option. You can specify a username value as either Domain<em>UserName or UserName.

**Option ** Description
/recursive Displays all files and subfolders of a folder.
/version Specifies the version of the file to open for viewing the properties on.
/workspace Indicates the workspace to be used when displaying the "local" properties (such as location on disk).
/collection Specifies the team project collection.
/login Specifies the user name and password to authenticate the user with Team Foundation Server.


The properties command displays several pieces of information about a version-controlled item. Local and server information is listed separately.

Property Name


Local path

Indicates the local path of the workspace folder for the specified item.


Indicates the version number of the file or folder that was last retrieved to the current workspace using the Get Command.


Indicates where a change is pending.


Indicates the item type, for example file.

Server path

Indicates the full path of the item on the version control server.


Indicates the version number of the item.

Deletion ID

If the item is deleted, the deletion identification; otherwise 0.


Indicates the type of lock.

  • Checkin Check in is not permitted for the file.

  • Checkout Check out in not permitted for the file.

  • None A lock is not set. For more information, see Lock Command.

Lock Owner

Indicates the person who set a check-in lock.

Last modified

Indicates the date and time stamp for when the item was last modified.


Indicates the item type, for example file.

File Type

Displays the file type encoding. For example, Windows-1252.


Indicates the size of the file in bytes.

For links to other Team Foundation commands that describe the items on the server and the workspaces that map to the server, see Informational Commands.

For more information on how to find the tf command-line utility, see Tf Command-Line Utility Commands.


The following example displays properties information about the file 314.cs.

c:\projects>tf properties 314.cs

The following example displays the properties of the working folder c:\projects\objects.

c:\projects>tf properties objects

See Also


View Version Control File and Folder Properties


Command-Line Syntax (Version Control)

Permission Command

Status Command

History Command

Changeset Command

Shelvesets Command


Informational Commands

Other Resources

Tf Command-Line Utility Commands