Microsoft.Common.ManagementGroupSelector UI element

The ManagementGroupSelector user-interface (UI) element lets users select a management group. Use it for management-group-scope deployments.

UI sample

The ManagementGroupSelector element renders a management-group picker.

Schema

{
  "name": "managementGroup",
  "type": "Microsoft.Common.ManagementGroupSelector",
  "constraints": [
    {
      "isValid": "[not(empty(steps('basics').managementGroup.managementGroupId))]",
      "message": "Select a management group."
    }
  ],
  "visible": true
}

Sample output

{
  "displayName": "Contoso management group",
  "managementGroupId": "contoso-mg"
}

Remarks

• The selected value includes displayName and managementGroupId.
• For a management-group-scope deployment, set view.outputs.kind to ManagementGroup and reference the selected management group with [steps('basics').managementGroup.managementGroupId].
• constraints is an optional array of custom validation rules. Each rule has an isValid expression and a message.

Next steps

• Form view elements
• Create portal forms for template specs