Merge pull request #313550 from mbender-ms/avnm-modular-includes

AVNM | Maintenance | Modular content update

Author: AnnaMHuff

articles/networking/includes/azure-virtual-network-manager/create-resource-group.md

@@ -0,0 +1,29 @@
+---
+title: include file
+description: include file
+services: virtual-network-manager
+author: mbender-ms
+ms.service: azure-virtual-network-manager
+ms.topic: include
+ms.date: 03/23/2026
+ms.author: mbender
+ms.custom: include file
+---
+
+## Create a resource group
+
+Create a resource group to hold the resources used in this article.
+
+1. Sign in to the [Azure portal](https://portal.azure.com/).
+
+1. Select **+ Create a resource** and search for **Resource group**. Then select **Resource group** > **Create**.
+
+1. On the **Basics** tab, enter or select the following information:
+
+    | Setting | Value |
+    | ------- | ----- |
+    | **Subscription** | Select your subscription. |
+    | **Resource group** | Enter a name for the resource group. |
+    | **Region** | Select a region for the resource group. |
+
+1. Select **Review + create** and then **Create**.

articles/networking/includes/azure-virtual-network-manager/virtual-network-manager-create-instance-portal.md

@@ -0,0 +1,45 @@
+---
+title: include file
+description: include file
+services: virtual-network-manager
+author: mbender-ms
+ms.service: azure-virtual-network-manager
+ms.topic: include
+ms.date: 03/23/2026
+ms.author: mbender
+ms.custom: include file
+---
+
+## Create a Virtual Network Manager instance
+
+Deploy a Virtual Network Manager instance with the defined scope and features needed using the Azure portal.
+
+> [!IMPORTANT]
+> Virtual Network Manager requires specific permissions within the defined scope. Make sure you have the necessary [Azure Role-based Access Control (RBAC) roles](../../../virtual-network-manager/concept-network-groups.md#network-groups-and-azure-policy) before creating the instance.
+
+1. Sign in to the [Azure portal](https://portal.azure.com/).
+
+1. Select **+ Create a resource** and search for **Network Manager**. Then select **Network Manager** > **Create** to begin setting up Virtual Network Manager.
+
+1. On the **Basics** tab, enter or select the following information:
+
+    | Setting | Value |
+    | ------- | ----- |
+    | **Subscription** | Select the subscription containing your existing virtual networks. |
+    | **Resource group** | Select the existing resource group where you want to deploy Virtual Network Manager. |
+    | **Name** | Enter a name for your Virtual Network Manager instance. |
+    | **Region** | Select a region for your Virtual Network Manager instance. Virtual Network Manager can manage virtual networks in any region. The selected region is where the Virtual Network Manager instance will be deployed. |
+    | **Description** | *(Optional)* Provide a description of this Virtual Network Manager instance and the task it manages. |
+    | [Features](../../../virtual-network-manager/concept-network-manager-scope.md#features) | Select the features you need from the dropdown list: <br> - **Connectivity**: Enables the creation of a full mesh or hub-and-spoke network topology between virtual networks within the scope. <br> - **Security Admin**: Enables the creation of global network security rules. <br> - **Routing**: Enables the creation and management of user-defined routes at scale. |
+
+1. Select the **Management scope** tab or **Next: Management scope** to continue.
+
+1. On the **Management scope** tab, select **+ Add**.
+
+1. In the **Add scopes** pane, select the subscriptions or management groups containing your existing virtual networks, and then select **Select**.
+
+1. Select **Review + create** to validate your configuration.
+
+1. After validation passes, select **Create** to deploy the Virtual Network Manager instance.
+
+The Virtual Network Manager instance is now created and ready to manage your existing virtual networks within the defined scope.

articles/networking/includes/azure-virtual-network-manager/virtual-network-manager-create-network-group.md

@@ -0,0 +1,26 @@
+---
+title: include file
+description: include file
+services: virtual-network-manager
+author: mbender-ms
+ms.service: azure-virtual-network-manager
+ms.topic: include
+ms.date: 03/23/2026
+ms.author: mbender
+ms.custom: include file
+---
+
+1. Browse to your resource group, and select your Virtual Network Manager resource.
+
+1. Under **Settings**, select **Network groups**. Then select **+ Create**.
+
+1. On the **Create a network group** pane, enter or select the following information, and then select **Create**:
+
+    | Setting | Value |
+    | ------- | ----- |
+    | **Name** | Enter a name for your network group. |
+    | **Description** | *(Optional)* Provide a description of this network group. |
+    | **Member type** | Select **Virtual network** from the dropdown menu. |
+
+1. Confirm that the new network group is now listed on the **Network groups** pane.
+

articles/virtual-network-manager/create-virtual-network-manager-portal.md

@@ -1,11 +1,11 @@
 ---
 title: 'Quickstart: Create a mesh network topology with Azure Virtual Network Manager - Azure portal'
-description: Learn to a mesh virtual network topology with Azure Virtual Network Manager by using the Azure portal.
+description: Learn to create a mesh virtual network topology with Azure Virtual Network Manager by using the Azure portal.
 author: mbender-ms
 ms.author: mbender
 ms.service: azure-virtual-network-manager
 ms.topic: quickstart
-ms.date: 07/11/2025
+ms.date: 03/23/2026
 ms.custom:
   - template-quickstart
   - mode-ui
@@ -26,7 +26,28 @@ In this quickstart, you deploy three virtual networks and use Azure Virtual Netw
 - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn).
 - To modify network groups using Azure Policy to conditionally define membership, you must be [granted access through Azure Role-based Access Control (RBAC) role](concept-network-groups.md#network-groups-and-azure-policy) assignment only. Classic Admin or legacy authorization isn't supported.
 
-[!INCLUDE [virtual-network-manager-create-instance](../../includes/virtual-network-manager-create-instance.md)]
+## Sample values
+
+This quickstart uses the following sample values for creating resources. Use these values to follow along, or replace them with your own.
+
+| Resource | Sample value |
+| --- | --- |
+| Resource group | **resource-group** |
+| Network Manager name | **network-manager** |
+| Region | **West US 2** |
+| Virtual networks | **vnet-00**, **vnet-01**, **vnet-02** |
+| VNet address spaces | **10.0.0.0/16**, **10.1.0.0/16**, **10.2.0.0/16** |
+| Network group | **network-group** |
+| Connectivity configuration | **connectivity-configuration** |
+| Azure Policy name | **azure-policy** |
+| Tag | Name: **NetworkType** / Value: **Production** |
+
+[!INCLUDE [create-resource-group](../networking/includes/azure-virtual-network-manager/create-resource-group.md)]
+
+> [!NOTE]
+> For this quickstart, select **Connectivity** from the **Features** dropdown when creating your Virtual Network Manager instance. Use the sample values from the preceding table for the resource group, name, and region fields.
+
+[!INCLUDE [virtual-network-manager-create-instance-portal](../networking/includes/azure-virtual-network-manager/virtual-network-manager-create-instance-portal.md)]
 
 ## Create virtual networks
 
@@ -40,7 +61,7 @@ Create three virtual networks by using the portal. Each virtual network has a `n
     | ------- | ----- |
     | **Subscription** | Select the subscription where you want to deploy this virtual network. |
     | **Resource group** | Select **resource-group**. |
-    | **Virtual network name** | Enter **vnet-000**. |
+    | **Virtual network name** | Enter **vnet-00**. |
     | **Region** | Select **(US) West 2**. |
 
 1. Select the **IP addresses** tab.
@@ -70,16 +91,16 @@ Create three virtual networks by using the portal. Each virtual network has a `n
     | **Resource group** | Select **resource-group**. |
     | **Name** | Enter **vnet-01** and **vnet-02** for the other virtual networks. |
     | **Region** | Select **(US) West 2**. |
-    | **vnet-01 IP addresses** | IPv4 address space: **10.1.0.0/16** </br> Subnet name: **default** </br> Subnet address space: **10.1.0.0/24**|
-    | **vnet-01 Tags** | Name: **NetworkType** </br> Value: **Production** </br> Resource: **Virtual network**. |
-    | **vnet-02 IP addresses** | IPv4 address space: **10.2.0.0/16** </br> Subnet name: **default** </br> Subnet address space: **10.2.0.0/24**|
-    | **vnet-02 Tags** | Name: **NetworkType** </br> Value: **Production** </br> Resource: **Virtual network**. |
+    | **vnet-01 IP addresses** | IPv4 address space: **10.1.0.0/16** <br> Subnet name: **default** <br> Subnet address space: **10.1.0.0/24** |
+    | **vnet-01 Tags** | Name: **NetworkType** <br> Value: **Production** <br> Resource: **Virtual network**. |
+    | **vnet-02 IP addresses** | IPv4 address space: **10.2.0.0/16** <br> Subnet name: **default** <br> Subnet address space: **10.2.0.0/24** |
+    | **vnet-02 Tags** | Name: **NetworkType** <br> Value: **Production** <br> Resource: **Virtual network**. |
 
 ## Create a network group
 
 Azure Virtual Network Manager applies configurations to groups of virtual networks known as network groups. To create a network group:
 
-[!INCLUDE [virtual-network-manager-create-network-group](../../includes/virtual-network-manager-create-network-group.md)]
+[!INCLUDE [virtual-network-manager-create-network-group](../networking/includes/azure-virtual-network-manager/virtual-network-manager-create-network-group.md)]
 
 ## Define membership for a connectivity configuration
 
@@ -113,25 +134,25 @@ By using [Azure Policy](concept-azure-policy-integration.md), you define a condi
     | **Scope** | Choose **Select scopes** and then select your current subscription. |
     | **Parameter** | Select **Name** from the dropdown list.|
     | **Operator** | Select **Key value pair** from the dropdown list.|
-    | **Condition** | Enter name of **NetworkType**.</br> Enter value of **Production**. |
+    | **Condition** | Enter name of **NetworkType**.<br> Enter value of **Production**. |
 
     :::image type="content" source="./media/create-virtual-network-manager-portal/network-group-conditional-thumb.png" alt-text="Screenshot of the pane for creating an Azure policy, including criteria for definitions." lightbox="media/create-virtual-network-manager-portal/network-group-conditional.png":::
 
-2. The **Preview resources** pane shows the virtual networks for addition to the network group based on the defined conditions in Azure Policy. When you're ready, select **Close**.
+1. The **Preview resources** pane shows the virtual networks for addition to the network group based on the defined conditions in Azure Policy. When you're ready, select **Close**.
 
     :::image type="content" source="media/create-virtual-network-manager-portal/preview-virtual-networks.png" alt-text="Screenshot of the pane for previewing the virtual networks.":::
 
-3. Select **Save** to deploy the Azure Policy. It can take up to one minute for the policy to take effect and be added to your network group.
+1. Select **Save** to deploy the Azure Policy. It can take up to one minute for the policy to take effect and be added to your network group.
 
-4. On the **Network Group** pane, under **Settings**, select **Group members** to view the membership of the group based on the conditions that you defined in Azure Policy. Confirm the **Source** is listed as **azure-policy - subscriptions/subscription_id**.
+1. On the **Network Group** pane, under **Settings**, select **Group members** to view the membership of the group based on the conditions that you defined in Azure Policy. Confirm the **Source** is listed as **azure-policy - subscriptions/subscription_id**.
 
     :::image type="content" source="media/create-virtual-network-manager-portal/group-members-list.png" alt-text="Screenshot of listed group members with a configured source.":::
 
 ---
 
 ## Create a configuration
 
-Now that you created the network group and updated its membership with virtual networks, you create a mesh connectivity configuration. Replace `<subscription_id>` with your subscription.
+Now that you created the network group and updated its membership with virtual networks, you create a mesh connectivity configuration.
 
 1. Under **Settings**, select **Configurations**. Then select **Create**.
 

articles/virtual-network-manager/how-to-create-hub-and-spoke.md

@@ -26,7 +26,7 @@ This section helps you create a network group containing the virtual networks yo
 > [!NOTE]
 > This how-to guide assumes you created an Azure Virtual Network Manager instance using the [quickstart](create-virtual-network-manager-portal.md) guide.
 
-[!INCLUDE [virtual-network-manager-create-network-group](../../includes/virtual-network-manager-create-network-group.md)]
+[!INCLUDE [virtual-network-manager-create-network-group](../networking/includes/azure-virtual-network-manager/virtual-network-manager-create-network-group.md)]
 
 ## Define network group members
 

articles/virtual-network-manager/how-to-create-mesh-network.md

@@ -26,7 +26,7 @@ This section helps you create a network group containing the virtual networks yo
 > [!NOTE]
 > This how-to guide assumes you created an Azure Virtual Network Manager instance using the [quickstart](create-virtual-network-manager-portal.md) guide.
 
-[!INCLUDE [virtual-network-manager-create-network-group](../../includes/virtual-network-manager-create-network-group.md)]
+[!INCLUDE [virtual-network-manager-create-network-group](../networking/includes/azure-virtual-network-manager/virtual-network-manager-create-network-group.md)]
 
 ## Define network group members
 

articles/virtual-network-manager/tutorial-create-secured-hub-and-spoke.md

@@ -119,7 +119,7 @@ Deploy a virtual network gateway into the hub virtual network. This virtual netw
 > [!NOTE]
 > This how-to guide assumes you created an Azure Virtual Network Manager instance using the [quickstart](create-virtual-network-manager-portal.md) guide. The network group in this tutorial is called **ng-learn-prod-eastus-001**.
 
-[!INCLUDE [virtual-network-manager-create-network-group](../../includes/virtual-network-manager-create-network-group.md)]
+[!INCLUDE [virtual-network-manager-create-network-group](../networking/includes/azure-virtual-network-manager/virtual-network-manager-create-network-group.md)]
 
 ## Define dynamic group membership with Azure Policy