This documentation is archived and is not being maintained.


Use the TFSFieldMapping utility to change or customize the project mapping XML file after creating a team project. For example, you can create new work item types or modify existing ones to have new attributes.

The TFSFieldMapping command-line utility is located in <drive>:\Program Files\Visual Studio 9.0\Common7\IDE on Team Explorer client computer.


Even if you are logged on with administrative credentials, you must open an elevated Command Prompt to perform this function on a server that is running Windows Server 2008. To open an elevated Command Prompt, click Start, right-click Command Prompt, and click Run as Administrator. For more information, see the Microsoft Web site.

Required Permissions

To use the TFSFieldMapping command, you must be a member of the Team Foundation Administrators or the Project Administrators security group. For more information, see Team Foundation Server Permissions and Team Foundation Server Default Groups, Permissions, and Roles.

TFSFieldMapping upload | download serverurl projectname filepath 




URL of the server.


Name of the team project. If the name contains spaces, enclose the name in quotes.


Name and file path of the mapping file.



Upload | download

Download or upload the field mapping file.

The steps involved in customizing the field mapping file are:

  1. Download the field mapping file by using the TFSFieldMapping command-line utility.

  2. Edit the field mapping file by modifying existing fields, or by adding custom fields and attributes. For more information, see How to: Change How Fields are Mapped to Microsoft Project

  3. Upload the field mapping file by using the TFSFieldMapping command-line utility.

The following command instructs the TFSFieldMapping utility to download the mapping file, MappingFile.xml that is located on drive C. The location of your mapping file can differ.

>TFSFieldMapping download http://TeamFoundationServer AdventureWorks C:\MappingFile.xml 

In the above code:

  • http://TeamFoundationServer is the URL of the server.

  • AdventureWorks is the name of the team project.

  • C:\MappingFile.xml is the name and location of the field mapping file.