Azure DevOps Migration Tools

v16.0.2

Azure DevOps Migration Tools allow you to migrate Teams, Backlogs, Tasks, Test Cases, and Plans & Suits from one Project to another in Azure DevOps / TFS both within the same Organisation, and between Organisations.

Home
 › 
Learn
 › 
Overview
 › 
Reference
 › 
Tools
 › 
Tfsteamsettingstool
Overview

TfsTeamSettingsTool

Ref

  

Less than 1 minute to read

  

2024-09-10 16:11:58 +0000

The TfsUserMappingTool is used to map users from the source to the target system. Run it with the ExportUsersForMappingContext to create a mapping file then with WorkItemMigrationContext to use the mapping file to update the users in the target system as you migrate the work items.

Options

Parameter name Type Description Default Value
Enabled Boolean If set to `true` then the tool will run. Set to `false` and the processor will not run. missng XML code comments
MigrateTeamCapacities Boolean Migrate original team member capacities after their creation on the target team project. Note: It will only migrate team member capacity if the team member with same display name exists on the target collection otherwise it will be ignored. false
MigrateTeamSettings Boolean Migrate original team settings after their creation on target team project false
Teams List List of Teams to process. If this is `null` then all teams will be processed. missng XML code comments
UpdateTeamSettings Boolean Reset the target team settings to match the source if the team exists false

Examples

defaults

1
2
3
4
5
6
7
8
9
10
11
12
13
14
    {
  "MigrationTools": {
    "CommonTools": {
      "TfsTeamSettingsTool": {
        "Enabled": "True",
        "MigrateTeamCapacities": "True",
        "MigrateTeamSettings": "True",
        "Teams": null,
        "UpdateTeamSettings": "True"
      }
    }
  }
}
    

sample

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
    {
  "MigrationTools": {
    "CommonTools": {
      "TfsTeamSettingsTool": {
        "Enabled": "True",
        "MigrateTeamCapacities": "True",
        "MigrateTeamSettings": "True",
        "Teams": [
          "Team 1",
          "Team 2"
        ],
        "UpdateTeamSettings": "True"
      }
    }
  }
}
    

classic

1
2
3
4
5
6
7
8
9
10
11
12
    {
  "$type": "TfsTeamSettingsToolOptions",
  "Enabled": true,
  "MigrateTeamSettings": true,
  "UpdateTeamSettings": true,
  "MigrateTeamCapacities": true,
  "Teams": [
    "Team 1",
    "Team 2"
  ]
}
    

...
Getting Support

Community Support

Question & Discussion - The first place to look for usage, configuration, and general help.

Commercial Support

We provide training, ad-hoc support, and full service migrations through Azure DevOps Migration Services