Merge pull request #289105 from mbender-ms/avnm-IPAM-updates-ARM

virtual network manager - Update IPAM docs

Author: AnnaMHuff

articles/virtual-network-manager/how-to-manage-ip-addresses-network-manager.md

@@ -5,7 +5,7 @@ author: mbender-ms
 ms.author: mbender
 ms.service: azure-virtual-network-manager
 ms.topic: how-to
-ms.date: 10/08/2024
+ms.date: 10/25/2024
 ms.custom:  references_regions
 #customer intent: As a network administrator, I want to learn how to manage IP addresses with Azure Virtual Network Manager so that I can create and assign IP address pools to my virtual networks.
 ---
@@ -139,6 +139,8 @@ In this step, you delegate permissions to other users to manage IP address pools
 
 In this step, you create a virtual network with a nonoverlapping CIDR range by allowing IP address manager to automatically provide a nonoverlapping CIDR.
 
+# [Azure Portal](#tab/azureportal)
+
 1. In the Azure portal, search for and select **Virtual networks**.
 2. Select **+ Create**.
 3. On the **Basics** tab, enter the following information:
@@ -166,6 +168,91 @@ In this step, you create a virtual network with a nonoverlapping CIDR range by a
 8. Optionally create subnets referring to the selected pool.
 9.  Select **Review + create** and then **Create** to create the virtual network.
 
+# [Azure Resource Manager Template](#tab/armtemplate)
+
+In this step, you create a virtual network with a nonoverlapping CIDR range using an Azure Resource Manager template. 
+
+1. Sign in to Azure and search for **Deploy a custom template**.
+2. In the **Custom deployment** window, select **Build your own template in the editor**.
+3. Copy the following template into the editor:
+
+    ```json
+       {
+        "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
+        "contentVersion": "1.0.0.0",
+        "parameters": {
+            "virtualNetworkName": {
+                "defaultValue": "virtual-network",
+                "type": "String",
+                "metadata": {
+                    "description": "VNet name"
+                }
+            },
+            "location": {
+                "defaultValue": "[resourceGroup().location]",
+                "type": "String",
+                "metadata": {
+                    "description": "Location for all resources."
+                }
+            },
+            "poolResourceID": {
+                "defaultValue": "/subscriptions/<subscriptionId>/resourceGroups/resourceGroupName/providers/Microsoft.Network/networkManagers/<networkManagerName>/ipamPools/<ipAddressPoolName>",
+                "type": "String",
+                "metadata": {
+                    "description": "Enter the Resource ID for your IP Address Pool. You can find this in the JSON View in the resource's overview window."
+                }
+            },
+            "numberOfIPAddresses": {
+                "defaultValue": "256",
+                "type": "String",
+                "metadata": {
+                    "description": "Enter the number of IP addresses for the virtual network."
+                }
+            }
+        },
+        "resources": [
+            {
+                "type": "Microsoft.Network/virtualNetworks",
+                "apiVersion": "2024-01-01",
+                "name": "[parameters('virtualNetworkName')]",
+                "location": "[parameters('location')]",
+                "properties": {
+                    "addressSpace": {
+                        "ipamPoolPrefixAllocations": [
+                            {
+                                "pool": {
+                                    "id": "[parameters('poolResourceID')]"
+                                },
+                                "numberOfIpAddresses": "[parameters('numberOfIPAddresses')]"
+                            }
+                        ]
+                    }
+                }
+            }
+        ]
+      }
+    
+    ```
+
+4. In the **Custom deployment** windows, enter or select the following information:
+
+    | **Field** | **Description** |
+    | --- | --- |
+    | **Project details** |   |
+    | Subscription | Select your subscription. |
+    | Resource group | Select the resource group for the virtual network. In this case, the example uses **resource-group**. |
+    | **Instance details** |   |
+    | Region | Select the region for the virtual network. IP address pools must be in the same region as your virtual network in order to be associated. |
+    | Virtual network name | Enter a name for the virtual network. The template will default to **virtual-network**. |
+    | Location | Select the location for the virtual network. This will be the same as the region except all lower case and no spaces.</br>For example, if the region is **(US)westus2**, the location will be **westus2**. |
+    
+    :::image type="content" source="media/how-to-manage-ip-addresses/custom-deployment-template.png" alt-text="Screenshot of custom deployment page with values.":::
+    
+    > [!NOTE]
+    > The **poolResourceID** parameter is the Resource ID for your IP Address Pool. You can find this in the JSON View in the resource's overview window.
+
+5. Select **Review + create** and then **Create** to create the virtual network.
+
 ## Next steps
 
 > [!div class="nextstepaction"]