Extend an existing Azure VNET to a Multi-VNET Configuration

Last updated: 12/22/2015

This template allows you to extend an existing single VNET environment to a Multi-VNET environment that extends across two datacenter regions using VNET-to-VNET gateways

This Azure Resource Manager template was created by a member of the community and not by Microsoft. Each Resource Manager template is licensed to you under a license agreement by its owner, not Microsoft. Microsoft is not responsible for Resource Manager templates provided and licensed by community members and does not screen for security, compatibility, or performance. Community Resource Manager templates are not supported under any Microsoft support program or service, and are made available AS IS without warranty of any kind.


Parameter Name Description
existingVnetName Name of the existing first VNET. This VNET must already have a subnet named GatewaySubnet defined with a minimum /29 address prefix
existingVnetLocation Region in which the first existing VNET is provisioned
newVnetName Name of the new second VNET.
newVnetAddressPrefix Address space for the second VNET. This address space must not overlap with the first VNET
newVnetSubnetName Name of the first subnet in the second VNET. Please note, an additional subnet called GatewaySubnet will be created where the VirtualNetworkGateway will be deployed. The name of that subnet must not be changed from GatewaySubnet.
newVnetSubnetPrefix The IP address prefix for the first subnet in the second VNET.
newVnetGatewaySubnetPrefix The prefix for the GatewaySubnet where the second VirtualNetworkGateway will be deployed. This must be at least /29.
sharedKey The shared key used to establish connection between the two VirtualNetworkGateways.

Use the template


New-AzResourceGroup -Name <resource-group-name> -Location <resource-group-location> #use this command when you need to create a new resource group for your deployment
New-AzResourceGroupDeployment -ResourceGroupName <resource-group-name> -TemplateUri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/201-extend-vnet-to-multi-vnet/azuredeploy.json
Install and configure Azure PowerShell

Command line

az group create --name <resource-group-name> --location <resource-group-location> #use this command when you need to create a new resource group for your deployment
az group deployment create --resource-group <my-resource-group> --template-uri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/201-extend-vnet-to-multi-vnet/azuredeploy.json
Install and Configure the Azure Cross-Platform Command-Line Interface