This documentation is archived and is not being maintained.


Use the TFSFieldMapping utility to change or customize the project mapping XML file after you create a team project. For example, you can create work item types or modify existing ones to have new attributes. For information about the project mapping XML file, see The Microsoft Project Field Mapping File.

The TFSFieldMapping command-line utility is located in Drive:\Program Files\Visual Studio 10.0\Common7\IDE on a Team Explorer client computer.


Even if you are logged on with administrative permissions, 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 then 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.

TFSFieldMapping upload | download /collection:CollectionURL /teamproject:ProjectName /mappingfile:MappingFile 




Specifies the URI of the team project collection in the following format: http://ServerName:Port/VirtualDirectoryName/CollectionName

If you do not specify a virtual directory is used, you must use the following format:


If you have previously connected to the server, you can specify the friendly name for the server instead of the URI.


Specfies the name of the team project whose mapping parameters you want to modify. If the name contains spaces, enclose it in quotation marks.


Specifies the name and file path of the mapping file.



upload | download

Specifies whether to download or upload the field mapping file.

Follow these steps to customize the field mapping file:

  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 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 /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /teamproject:AdventureWorks /mappingfile:C:\MappingFile.xml 

In the previous example, the following values apply:

  • URI for the team project collection: http://AdventureWorksServer:8080/AWTeam/Collection1

  • Project name: AdventureWorks

  • Mapping file name and path: C;\MappingFile.xml