witAdmin: Customize and manage objects for tracking work

Last Update: 4/14/2017

Team Services | TFS 2017 | TFS 2015 | TFS 2013

IMPORTANT

With witadmin, you can modify XML definition files to support the On-premises XML process model. For Hosted XML and Inheritance process models, you can only use witadmin commands to list information. For an overview of process models and what is supported, see Customize your work tracking experience.

You can change how you track your team's progress by creating and customizing objects that track work items. By using the witadmin command-line tool, you can create, delete, import, and export objects such as categories, global lists, global workflow, types of links, and types of work items. You can also permanently delete types of work item types, and you can delete, list, or change the attributes of fields in work item.

As the following illustration shows, you manage categories and types of and work items for each team project. You manage global lists, types of links, and fields in work item for each team project collection. You can customize global workflow for a team project or a collection.

Work Item Tracking Objects

TIP

With witadmin, you can import and export definition files. Other tools you can use include the Process Editor (requires that you have installed a version of Visual Studio):

Or, you can use the TFS Team Project Manager, an open-source client available from github.

How to run the witadmin command-line tool

To run the witadmin command-line tool, open a Command Prompt window where Visual Studio is installed. The witadmin command-line tool installs with any version of Visual Studio. You can access this tool by installing the free version of Visual Studio Community.

For TFS 2017 or Team Services:

cd %programfiles(x86)%\Microsoft Visual Studio 15.0\Common7\IDE  

For TFS 2015:

cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE  

For TFS 2013:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE  

On a 32-bit edition of Windows, replace %programfiles(x86)% with %programfiles%.

For most commands, you must be a member of the Project Administrators or Project Collection Administrators groups. For more information, see Add an administrator.

Global parameters

You can use the following parameters to display help text for witadmin.

Parameter Description
/help
or
/?
Displays the syntax and parameters for the witadmin command-line tool.
command /help
or
command /?
Displays the syntax and parameters for the witadmin command that you specify.

Index of witadmin commands

All work tracking objects—such as, work item types (WITs), process configuration, global lists— are customized by their XML definitions.

All witadmin commands can be run against an on-premises TFS. You can run list and export witadmin commands against a Team Services account. If you are new to work tracking customization and for definitions of the work tracking objects your can customize, see Customize your work tracking experience.

Work item types

  • destroywitd: Delete a WIT
  • exportwitd: Export a WIT file
  • importwitd: Import a WIT file
  • listwitd: List WIT names
  • renamewitd: Change a WIT display name

Fields

  • deletefield: Delete a field
  • listfields: List field attributes
  • indexfield: Turn field indexing on/off
  • changefield: Change a field attribute

Process configuration

  • exportprocessconfig: Export the ProcessConfiguration file
  • importprocessconfig: Import the ProcessConfiguration file

Link types

  • deletelinktype: Delete a link type
  • exportlinktype: Export a link type file
  • importlinktype: Import a link type file
  • listlinktypes: List the defined link types
  • reactivatelinktype: Reactivate or rename a link type

Global lists

  • destroygloballist: Delete a global list
  • exportgloballist: Export the global list
  • importgloballist: Import the global list
  • listgloballist: List all global list names

Global workflow

  • exportglobalworkflow: Export the global workflow file
  • importglobalworkflow: Import the global workflow file

Work items

  • witadmin destroywi: Permanently delete work items

Client cache

  • rebuildcache: Rebuild the client cache

Categories

  • exportcategories: Export the Categories file
  • importcategories: Import the Categories file