Updating Custom Person-Name Fields to Synchronize with Active Directory or Workgroups

You can modify the syncnamechanges attribute of fields that track person names so that they synchronize with data stored in Active Directory or a workgroup. You have to perform this update only to custom fields that you have added to your upgraded team project. System fields, such as Activated By, Assigned To, Created By, and Closed By, are updated to synchronize when your Team Foundation deployment is upgraded to Visual Studio Team Foundation Server 2010.

Required Permissions

To use the witadmin command-line tool, you must be a member of the Team Foundation Administrators group or a member of the Project Administrators group for the project. For more information, see Team Foundation Server Permissions.

Note

Even if you log on with administrative permissions, you must open an elevated Command Prompt window to perform this function on a server that is running Windows Server 2008. To open an elevated Command Prompt window, click Start, right-click Command Prompt, and then click Run as Administrator. For more information, see the Microsoft Web site: User Account Control.

Procedure

To rename a work item type

  1. On a computer where Visual Studio 2010 is installed, open a Command Prompt window.

  2. Change to the directory that contains the witadmin command-line tool by typing the following command and then pressing ENTER.

    cd Drive:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE

  3. Type the following command, substituting your data for the arguments that are shown, and then press ENTER:

    witadmin changefield /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /p:project /n:RefName /syncnamechanges:true
    

    The following command shows an example of how to change the synchronization for the field AW.ProjectLead:

    witadmin changefield /collection:"http://MyServer:8080/tfs/Collection0" /p:MyProject /n:AW.ProjectLead /syncnamechanges:true

See Also

Reference

Managing Work Item Fields [witadmin]

Concepts

Updating an Upgraded Team Project to Access New Features