Merge pull request #281370 from ShawnJackson/articles-about-management-groups

[AQ] edit pass: Articles about management groups

Author: ktoliver

articles/azure-resource-manager/bicep/deploy-to-management-group.md

@@ -250,7 +250,7 @@ To use an ARM template to create a new Azure subscription in a management group,
 * [Programmatically create Azure subscriptions for a Microsoft Customer Agreement](../../cost-management-billing/manage/programmatically-create-subscription-microsoft-customer-agreement.md)
 * [Programmatically create Azure subscriptions for a Microsoft Partner Agreement](../../cost-management-billing/manage/programmatically-create-subscription-microsoft-partner-agreement.md)
 
-To deploy a template that moves an existing Azure subscription to a new management group, see [Move subscriptions in ARM template](../../governance/management-groups/manage.md#move-subscriptions-in-arm-template)
+To deploy a template that moves an existing Azure subscription to a new management group, see [Move subscriptions in ARM template](../../governance/management-groups/manage.md#move-a-subscription-in-an-arm-template)
 
 ## Azure Policy
 

articles/azure-resource-manager/management/move-resource-group-and-subscription.md

@@ -66,7 +66,7 @@ There are some important steps to do before moving a resource. By verifying thes
    * [Networking move guidance](./move-limitations/networking-move-limitations.md)
    * [Recovery Services move guidance](../../backup/backup-azure-move-recovery-services-vault.md?toc=/azure/azure-resource-manager/toc.json)
    * [Virtual Machines move guidance](./move-limitations/virtual-machines-move-limitations.md)
-   * To move an Azure subscription to a new management group, see [Move subscriptions](../../governance/management-groups/manage.md#move-subscriptions).
+   * To move an Azure subscription to a new management group, see [Move subscriptions](../../governance/management-groups/manage.md#move-management-groups-and-subscriptions).
 
 1. The destination subscription must be registered for the resource provider of the resource being moved. If not, you receive an error stating that the **subscription is not registered for a resource type**. You might see this error when moving a resource to a new subscription, but that subscription has never been used with that resource type.
 

articles/azure-resource-manager/templates/deploy-to-management-group.md

@@ -234,7 +234,7 @@ To use an ARM template to create a new Azure subscription in a management group,
 * [Programmatically create Azure subscriptions for a Microsoft Customer Agreement](../../cost-management-billing/manage/programmatically-create-subscription-microsoft-customer-agreement.md)
 * [Programmatically create Azure subscriptions for a Microsoft Partner Agreement](../../cost-management-billing/manage/programmatically-create-subscription-microsoft-partner-agreement.md)
 
-To deploy a template that moves an existing Azure subscription to a new management group, see [Move subscriptions in ARM template](../../governance/management-groups/manage.md#move-subscriptions-in-arm-template)
+To deploy a template that moves an existing Azure subscription to a new management group, see [Move subscriptions in ARM template](../../governance/management-groups/manage.md#move-a-subscription-in-an-arm-template)
 
 ## Azure Policy
 

articles/cost-management-billing/manage/programmatically-create-subscription-enterprise-agreement.md

@@ -499,5 +499,5 @@ resource subToMG 'Microsoft.Management/managementGroups/subscriptions@2020-05-01
 
 * Now that you created a subscription, you can grant that ability to other users and service principals. For more information, see [Grant access to create Azure Enterprise subscriptions (preview)](grant-access-to-create-subscription.md).
 * For more information about managing large numbers of subscriptions using management groups, see [Organize your resources with Azure management groups](../../governance/management-groups/overview.md).
-* To change the management group for a subscription, see [Move subscriptions](../../governance/management-groups/manage.md#move-subscriptions).
+* To change the management group for a subscription, see [Move subscriptions](../../governance/management-groups/manage.md#move-management-groups-and-subscriptions).
 * For advanced subscription creation scenarios using REST API, see [Alias - Create](/rest/api/subscription/2021-10-01/alias/create).

articles/cost-management-billing/manage/programmatically-create-subscription-microsoft-customer-agreement-across-tenants.md

@@ -196,4 +196,4 @@ Content-Type: application/json
 
 * Now that you've created a subscription, you can grant that ability to other users and service principals. For more information, see [Grant access to create Azure Enterprise subscriptions (preview)](grant-access-to-create-subscription.md).
 * For more information about managing large numbers of subscriptions using management groups, see [Organize your resources with Azure management groups](../../governance/management-groups/overview.md).
-* To change the management group for a subscription, see [Move subscriptions](../../governance/management-groups/manage.md#move-subscriptions).
+* To change the management group for a subscription, see [Move subscriptions](../../governance/management-groups/manage.md#move-management-groups-and-subscriptions).

articles/cost-management-billing/manage/programmatically-create-subscription-microsoft-customer-agreement.md

@@ -613,5 +613,5 @@ resource subToMG 'Microsoft.Management/managementGroups/subscriptions@2020-05-01
 
 * Now that you've created a subscription, you can grant that ability to other users and service principals. For more information, see [Grant access to create Azure Enterprise subscriptions (preview)](grant-access-to-create-subscription.md).
 * For more information about managing large numbers of subscriptions using management groups, see [Organize your resources with Azure management groups](../../governance/management-groups/overview.md).
-* To change the management group for a subscription, see [Move subscriptions](../../governance/management-groups/manage.md#move-subscriptions).
+* To change the management group for a subscription, see [Move subscriptions](../../governance/management-groups/manage.md#move-management-groups-and-subscriptions).
 * For advanced subscription creation scenarios using REST API, see [Alias - Create](/rest/api/subscription/2021-10-01/alias/create).

articles/governance/management-groups/create-management-group-azure-cli.md

@@ -30,9 +30,9 @@ directory. You receive a notification when the process is complete. For more inf
 
 - Any Microsoft Entra ID user in the tenant can create a management group without the management group write
   permission assigned to that user if
-  [hierarchy protection](./how-to/protect-resource-hierarchy.md#setting---require-authorization)
+  [hierarchy protection](./how-to/protect-resource-hierarchy.md#setting-require-authorization)
   isn't enabled. This new management group becomes a child of the Root Management Group or the
-  [default management group](./how-to/protect-resource-hierarchy.md#setting---default-management-group)
+  [default management group](./how-to/protect-resource-hierarchy.md#setting-define-the-default-management-group)
   and the creator is given an "Owner" role assignment. Management group service allows this ability
   so that role assignments aren't needed at the root level. No users have access to the Root
   Management Group when it's created. To avoid the hurdle of finding the Microsoft Entra ID Global Admins to

articles/governance/management-groups/create-management-group-dotnet.md

@@ -30,9 +30,9 @@ directory. You receive a notification when the process is complete. For more inf
 
 - Any Microsoft Entra ID user in the tenant can create a management group without the management group write
   permission assigned to that user if
-  [hierarchy protection](./how-to/protect-resource-hierarchy.md#setting---require-authorization)
+  [hierarchy protection](./how-to/protect-resource-hierarchy.md#setting-require-authorization)
   isn't enabled. This new management group becomes a child of the Root Management Group or the
-  [default management group](./how-to/protect-resource-hierarchy.md#setting---default-management-group)
+  [default management group](./how-to/protect-resource-hierarchy.md#setting-define-the-default-management-group)
   and the creator is given an "Owner" role assignment. Management group service allows this ability
   so that role assignments aren't needed at the root level. No users have access to the Root
   Management Group when it's created. To avoid the hurdle of finding the Microsoft Entra ID Global Admins to

articles/governance/management-groups/create-management-group-go.md

@@ -31,9 +31,9 @@ directory. You receive a notification when the process is complete. For more inf
 
 - Any Microsoft Entra ID user in the tenant can create a management group without the management group write
   permission assigned to that user if
-  [hierarchy protection](./how-to/protect-resource-hierarchy.md#setting---require-authorization)
+  [hierarchy protection](./how-to/protect-resource-hierarchy.md#setting-require-authorization)
   isn't enabled. This new management group becomes a child of the Root Management Group or the
-  [default management group](./how-to/protect-resource-hierarchy.md#setting---default-management-group)
+  [default management group](./how-to/protect-resource-hierarchy.md#setting-define-the-default-management-group)
   and the creator is given an "Owner" role assignment. Management group service allows this ability
   so that role assignments aren't needed at the root level. No users have access to the Root
   Management Group when it's created. To avoid the hurdle of finding the Microsoft Entra ID Global Admins to
@@ -85,39 +85,39 @@ that can create a management group.
    package main
 
    import (
-   	"context"
-   	"fmt"
-   	"os"
+     "context"
+     "fmt"
+     "os"
 
-   	mg "github.com/Azure/azure-sdk-for-go/services/resources/mgmt/2020-05-01/managementgroups"
-   	"github.com/Azure/go-autorest/autorest/azure/auth"
+     mg "github.com/Azure/azure-sdk-for-go/services/resources/mgmt/2020-05-01/managementgroups"
+     "github.com/Azure/go-autorest/autorest/azure/auth"
    )
 
    func main() {
-   	// Get variables from command line arguments
-   	var mgName = os.Args[1]
-
-   	// Create and authorize a client
-   	mgClient := mg.NewClient()
-   	authorizer, err := auth.NewAuthorizerFromCLI()
-   	if err == nil {
-   		mgClient.Authorizer = authorizer
-   	} else {
-   		fmt.Printf(err.Error())
-   	}
-
-   	// Create the request
-   	Request := mg.CreateManagementGroupRequest{
-   		Name: &mgName,
-   	}
-
-   	// Run the query and get the results
-   	var results, queryErr = mgClient.CreateOrUpdate(context.Background(), mgName, Request, "no-cache")
-   	if queryErr == nil {
-   		fmt.Printf("Results: " + fmt.Sprint(results) + "\n")
-   	} else {
-   		fmt.Printf(queryErr.Error())
-   	}
+     // Get variables from command line arguments
+     var mgName = os.Args[1]
+
+     // Create and authorize a client
+     mgClient := mg.NewClient()
+     authorizer, err := auth.NewAuthorizerFromCLI()
+     if err == nil {
+       mgClient.Authorizer = authorizer
+     } else {
+       fmt.Printf(err.Error())
+     }
+
+     // Create the request
+     Request := mg.CreateManagementGroupRequest{
+       Name: &mgName,
+     }
+
+     // Run the query and get the results
+     var results, queryErr = mgClient.CreateOrUpdate(context.Background(), mgName, Request, "no-cache")
+     if queryErr == nil {
+       fmt.Printf("Results: " + fmt.Sprint(results) + "\n")
+     } else {
+       fmt.Printf(queryErr.Error())
+     }
    }
    ```
 

articles/governance/management-groups/create-management-group-javascript.md

@@ -28,9 +28,9 @@ directory. You receive a notification when the process is complete. For more inf
 
 - Any Microsoft Entra ID user in the tenant can create a management group without the management group write
   permission assigned to that user if
-  [hierarchy protection](./how-to/protect-resource-hierarchy.md#setting---require-authorization)
+  [hierarchy protection](./how-to/protect-resource-hierarchy.md#setting-require-authorization)
   isn't enabled. This new management group becomes a child of the Root Management Group or the
-  [default management group](./how-to/protect-resource-hierarchy.md#setting---default-management-group)
+  [default management group](./how-to/protect-resource-hierarchy.md#setting-define-the-default-management-group)
   and the creator is given an "Owner" role assignment. Management group service allows this ability
   so that role assignments aren't needed at the root level. No users have access to the Root
   Management Group when it's created. To avoid the hurdle of finding the Microsoft Entra ID Global Admins to