Permanently Removing Work Items
You can permanently remove one or more work items from the Team Foundation database for a team project collection by using the witadmin destroywi command. Work items whose state is set to Closed remain in the database and can be reactivated. Permanently removed work items are removed from the database and cannot be restored nor reactivated.
Each work item represents an object that is stored in the Team Foundation database and that is assigned a unique identifier, which is referred to as a work item ID. Work item IDs are unique within a project collection.
The witadmin command-line utility is located in Drive:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE on the client computer that runs Team Explorer.
Required Permissions
To permanently remove work items, you must be a member of the Team Foundation Administrators security group or the Project Administrators security group for the team project collection. For more information, see Team Foundation Server Permissions and Team Foundation Server Default Groups, Permissions, and Roles.
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 click Run as Administrator. For more information, see the Microsoft Web site.
witadmin destroywi /collection:CollectionURL /id:id [/noprompt]
Parameters
Parameter |
Description |
|---|---|
/collection:CollectionURL |
Specifies the URI of the team project collection. The format for the URI is the following: http://ServerName:Port/VirtualDirectoryName/CollectionName If no virtual directory is used, then the format for the URI is the following: http://ServerName:Port/CollectionName. |
/id:id |
The ID of a work item to destroy. To specify multiple work items, separate IDs using only commas, without whitepace. |
/noprompt |
Disables the prompt for confirmation. |
/? or help |
Displays help about the command in the Command Prompt window. |
Examples
Permanently Remove Work Items From the Database
The following example deletes the work item 2003 from the database for Collection1 on the AdventureWorksServer server:
witadmin destroywi /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /id:2003
The following example deletes the work items with IDs, 12, 15, and 23 from the database for Collection1 on the AdventureWorksServer server:
witadmin destroywi /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /id:12,15,23
See Also
Tasks
Resolve, Close, or Reactivate a Work Item