Extend an existing Azure VNET to a Multi-VNET Configuration

Last updated: 22/12/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 (ARM) template was created by a member of the community and not by Microsoft. Each ARM template is licensed to you under a licence agreement by its owner, not Microsoft. Microsoft is not responsible for ARM templates provided and licensed by community members and does not screen for security, compatibility or performance. Community ARM templates are not supported under any Microsoft support programme 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-AzureRmResourceGroupDeployment -Name <deployment-name> -ResourceGroupName <resource-group-name> -TemplateUri https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/201-extend-vnet-to-multi-vnet/azuredeploy.json
Installing and configuring Azure PowerShell
Command line
azure config mode arm
azure group deployment create <my-resource-group> <my-deployment-name> --template-uri https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/201-extend-vnet-to-multi-vnet/azuredeploy.json
Installing and configuring the Azure cross-platform command-line interface