Tfs Revision Manager Tool

The TfsRevisionManagerTool manipulates the revisions of a work item to reduce the number of revisions that are migrated.

Last updated: July 28, 2025 | Edit this page | Discuss this page

The TfsRevisionManagerTool manipulates the revisions of a work item to reduce the number of revisions that are migrated.

top

Options

Parameter
Type
Description
Default Value
Parameter:
Enabled
Type:
Boolean
Description:
If set to true then the tool will run. Set to false and the processor will not run.
Default Value:
missing XML code comments
Parameter:
MaxRevisions
Type:
Int32
Description:
Sets the maximum number of revisions that will be migrated. “First + Last N = Max”. If this was set to 5 and there were 10 revisions you would get the first 1 (creation) and the latest 4 migrated.
Default Value:
Not specified
Parameter:
ReplayRevisions
Type:
Boolean
Description:
You can choose to migrate the tip only (a single write) or all of the revisions (many writes). If you are setting this to false to migrate only the tip then you should set BuildFieldTable to true.
Default Value:
true
top

Samples

top

Sample

Sample

{
  "MigrationTools": {
    "Version": "16.0",
    "CommonTools": {
      "TfsRevisionManagerTool": {
        "Enabled": "True",
        "MaxRevisions": "0",
        "ReplayRevisions": "True"
      }
    }
  }
}
top

Defaults

Defaults

{
  "MigrationTools": {
    "Version": "16.0",
    "CommonTools": {
      "TfsRevisionManagerTool": {
        "Enabled": "True",
        "MaxRevisions": "0",
        "ReplayRevisions": "True"
      }
    }
  }
}
top

Classic

Classic

{
  "$type": "TfsRevisionManagerToolOptions",
  "Enabled": true,
  "ReplayRevisions": true,
  "MaxRevisions": 0
}
top

Metadata

top

Schema

This is the JSON schema that defines the structure and validation rules for this configuration.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://devopsmigration.io/schema/schema.tools.tfsrevisionmanagertool.json",
  "title": "TfsRevisionManagerTool",
  "description": "The TfsRevisionManagerTool manipulates the revisions of a work item to reduce the number of revisions that are migrated.",
  "type": "object",
  "properties": {
    "enabled": {
      "description": "If set to `true` then the tool will run. Set to `false` and the processor will not run.",
      "type": "boolean"
    },
    "maxRevisions": {
      "description": "Sets the maximum number of revisions that will be migrated. \"First + Last N = Max\". If this was set to 5 and there were 10 revisions you would get the first 1 (creation) and the latest 4 migrated.",
      "type": "integer",
      "default": "0"
    },
    "replayRevisions": {
      "description": "You can choose to migrate the tip only (a single write) or all of the revisions (many writes). If you are setting this to `false` to migrate only the tip then you should set `BuildFieldTable` to `true`.",
      "type": "boolean",
      "default": "true"
    }
  }
}
Project Information
Azure DevOps Marketplace
YouTube Channel
Maintainer

Created and maintained by Martin Hinshelwood of nkdagility.com

Getting Support
Community Support
Questions & Discussions

The first place to look for usage, configuration, and general help.

Commercial Support

We provide training, ad-hoc support, and full service migrations through our professional services.

Azure DevOps Migration Services
Documentation