witAdmin: Administrating Work Item Tracking Objects

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

You can change how you track your team's progress by creating and customizing work item tracking objects. With the witadmin command-line utility, you can create, delete, import, and export categories, global lists, types of links, types of work items, and work item fields. Management of these objects is performed for a project collection or a specific team project.

Prerequisites

To use the witadmin command-line utility, the following Team Foundation Server servers and services must be running on a network and you must have an operational connection:

  • Application-tier server for Team Foundation Server

  • Microsoft SQL Server 2008

  • Microsoft SQL Server Reporting Services

  • Active Directory Domain Controller

  • Internet Information Services (IIS) 6.0 or 7.0

  • .NET Framework 

Global Options

You can use any of the following parameters with any witadmin command.

Option

Description

/help

or

/?

Displays the command syntax and options for witadmin.

command /help

or

command /?

Displays the command syntax and options for the witadmin specified command.

Common Tasks

Tasks

Related content

Create and modify work item types. Work item types define the fields and behavior used to create and manage work items. You can create work item types and modify existing work item types to support the process objectives of your team and team project.

Create and modify groups of work item types. Categories allow you to group work item types to manage them according to their category. You can manage categories for a team project. Categories work with the new operators supported in the query filter criteria.

Create, modify, export, import, and display global lists for work item types. Global lists enable you to share list items among multiple work item types by including the list items in one or more GLOBALLIST elements. You manage global lists for a team project collection.

Create, modify, list, activate and deactivate, and import and export link types. Link types enable you to associate work items based on predefined set of link rules. When you create custom link types, it provides flexibility in how you track work items and their dependencies. You manage link types for a team project collection.

Delete, list, and rename work item type fields, and redefine the indexing and reporting characteristics of work item type fields. Fields are used to track information for a work item and to find work items using queries. You manage fields for a team project collection.

Destroy work items. You can permanently remove work items from the work item tracking database for a team project collection.

Force a rebuild of the client cache. After certain maintenance operations, such as a move, rename, restore, or fail-over of a data-tier or application-tier server, you can force a rebuild of the cache of all client computers that connect to a team project collection. This operation helps prevent workspace errors during version control or build operations.

See Also

Concepts

Other Resources

Page view tracker