Tfs Team Settings Tool

Tool for migrating team settings including team configurations, area paths, iterations, and team-specific settings from source to target Team Foundation Server or Azure DevOps.

Last updated: June 25, 2025 | Edit this page | Discuss this page

Tool for migrating team settings including team configurations, area paths, iterations, and team-specific settings from source to target Team Foundation Server or Azure DevOps.

top

Options

Parameter Type Description Default Value
Enabled Boolean If set to true then the tool will run. Set to false and the processor will not run. missing 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. Not specified
MigrateTeamSettings Boolean Migrate original team settings after their creation on target team project Not specified
Teams List List of Teams to process. If this is null then all teams will be processed. missing XML code comments
UpdateTeamSettings Boolean Reset the target team settings to match the source if the team exists Not specified
UseUserMapping Boolean Use user mapping file from TfsTeamSettingsTool when matching users when migrating capacities. By default, users in source are matched in target users by current display name. When this is set to true, users are matched also by mapped name from user mapping file. missing XML code comments
top

Samples

top

Sample

Sample 

{
  "MigrationTools": {
    "Version": "16.0",
    "CommonTools": {
      "TfsTeamSettingsTool": {
        "Enabled": "True",
        "MigrateTeamCapacities": "True",
        "MigrateTeamSettings": "True",
        "Teams": [
          "Team 1",
          "Team 2"
        ],
        "UpdateTeamSettings": "True"
      }
    }
  }
}
top

Defaults

Defaults 

{
  "MigrationTools": {
    "Version": "16.0",
    "CommonTools": {
      "TfsTeamSettingsTool": {
        "Enabled": "True",
        "MigrateTeamCapacities": "True",
        "MigrateTeamSettings": "True",
        "Teams": null,
        "UpdateTeamSettings": "True"
      }
    }
  }
}
top

Classic

Classic 

{
  "$type": "TfsTeamSettingsToolOptions",
  "Enabled": true,
  "MigrateTeamSettings": true,
  "UpdateTeamSettings": true,
  "MigrateTeamCapacities": true,
  "UseUserMapping": false,
  "Teams": [
    "Team 1",
    "Team 2"
  ]
}
top

Metadata

Metadata

Class Name
TfsTeamSettingsTool
Status
Missing XML Code Comments
Processing Target
missing XML code comments
Type
Tools
Previous Tfs Revision Manager Tool
Next Tfs User Mapping Tool
Project Information
Azure DevOps Marketplace
Visual Studio Marketplace Stars View Extension
YouTube Channel
Youtube Subscribers Youtube Views
Maintainer

Created and maintained by Martin Hinshelwood of nkdagility.com

Documentation Versions
Production Azure DevOps Migration Tools Release Version
Preview Azure DevOps Migration Tools Preview Version
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