In this Azure PowerShell article, we will discuss the syntax and usage of the New-AzManagementGroup Azure PowerShell cmdlet with examples.
Table of Contents
New-AzManagementGroup
This is an excellent PowerShell cmdlet that can help you to quickly create a management group in a span of seconds.
Syntax
Below is the syntax of the New-AzManagementGroup PowerShell command.
New-AzManagementGroup
[-GroupId] <String>
New-AzManagementGroup
[-GroupId] <String>
[-DisplayName <String>]
New-AzManagementGroup
[-DisplayName <String>] [-GroupId] <String> [-ParentId <String>]
Now, let’s discuss how to use New-AzManagementGroup PowerShell command to create a management group in Azure with examples.
Example-1:
Execute the below PowerShell command to create a management group named as “TsinfoGroup” in Azure.
New-AzManagementGroup -GroupId "TsinfoGroup"
After executing the above PowerShell script, I got the below output
PS C:\WINDOWS\system32> New-AzManagementGroup -GroupId "TsinfoGroup"
WARNING: Upcoming breaking changes in the cmdlet 'New-AzManagementGroup' :
- The parameter : 'GroupName' is being replaced by parameter : 'GroupId'.
- Change description : We will replace GroupName with GroupId to make it more clear.
Note : Go to https://aka.ms/azps-changewarnings for steps to suppress this breaking cha
nge warning, and other information on breaking changes in Azure PowerShell.
Id : /providers/Microsoft.Management/managementGroups/TsinfoGroup
Type : Microsoft.Management/managementGroups
Name : TsinfoGroup
TenantId : 5d9d690a-0310-474d-ae8b-42df2d549228
DisplayName : TsinfoGroup
UpdatedTime : 4/17/2023 11:07:07 AM
UpdatedBy : 54481342-e592-47c2-ba89-b07dcadf9346
ParentId : /providers/Microsoft.Management/managementGroups/5d9d690a-0310-474
d-ae8b-42df2d549228
ParentName : 5d9d690a-0310-474d-ae8b-42df2d549228
ParentDisplayName : Tenant Root Group
You can see the same output as below

Example-2:
Execute the below PowerShell command to create a management group named as “NewTsInfoGroup” in Azure with Display name “TsInfo”.
New-AzManagementGroup -GroupId "NewTsInfoGroup" -DisplayName "TsInfo"
After executing the above command I got the below output
PS C:\WINDOWS\system32> New-AzManagementGroup -GroupId "NewTsInfoGroup" -DisplayName "TsInfo"
WARNING: Upcoming breaking changes in the cmdlet 'New-AzManagementGroup' :
- The parameter : 'GroupName' is being replaced by parameter : 'GroupId'.
- Change description : We will replace GroupName with GroupId to make it more clear.
Note : Go to https://aka.ms/azps-changewarnings for steps to suppress this breaking cha
nge warning, and other information on breaking changes in Azure PowerShell.
Id : /providers/Microsoft.Management/managementGroups/NewTsInfoGroup
Type : Microsoft.Management/managementGroups
Name : NewTsInfoGroup
TenantId : 5d9d690a-0310-474d-ae8b-42df2d549228
DisplayName : TsInfo
UpdatedTime : 4/17/2023 11:46:51 AM
UpdatedBy : 54481342-e592-47c2-ba89-b07dcadf9346
ParentId : /providers/Microsoft.Management/managementGroups/5d9d690a-0310-474
d-ae8b-42df2d549228
ParentName : 5d9d690a-0310-474d-ae8b-42df2d549228
ParentDisplayName : Tenant Root Group
Check out the same output on the below screen shot.

You may also like following the below Azure PowerShell articles
- Unable to cast object of type ‘Newtonsoft.Json.Linq.JObject’to type ‘Microsoft.Azure.Management.ManagementGroups.Models.ManagementGroup’
- New-AzResource
- Set-AzResourceGroup
Wrapping Up
In this Azure PowerShell article, we will discuss the syntax, usage of the New-AzManagementGroup PowerShell command with examples. Thanks for reading this article !!!