Setting up the Azure DevOps Migration Tools

If you want to perform a bulk edit or a migration then you need to start here. This tool has been tested on updating from 100 to 250,000 work items by its users. Watch the Video Overview to get started in 30 minutes. This tool is complicated and it’s not always easy to discover what you need to do.

Install Azure DevOps Migration Tools on Windows

Install the Azure DevOps Migration Tools on Windows. These tools are available as a portable application and can be installed in a number of ways, including manually from a zip.

Permissions

The current permissions are governed by the requirements of the TFS Client Object Model from Microsoft. While Microsoft announced the deprecation of the WIT and Test Client OM in 2020, it remains the only consistent method for interacting with versions of TFS from 2010 to 2018.

Reflected WorkItem Id

The Azure DevOps migrations Tools has no internal state, and uses a field on the work item to track the migration of work items. This field is always referred to in the docs as ReflectedWorkItemId and is used to track the work item in the target.