Skip Navigation

Connect an ExpressRoute circuit to a VNET

Last updated: 10/10/2015

This template creates a VNET, an ExpresRoute Gateway and a connection to a provisioned and enabled ExpressRoute circuit with AzurePrivatePeering configured.

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
gatewayType The type of gateway to deploy. For connecting to ExpressRoute circuits, the gateway must be of type ExpressRoute. Other types are Vpn.
connectionType The type of connection. For connecting to ExpressRoute circuits, the connectionType must be of type ExpressRoute. Other types are IPsec and Vnet2Vnet.
virtualNetworkName The name of the virtual network to create.
addressPrefix The address space in CIDR notation for the new virtual network.
subnetName The name of the first subnet in the new virtual network.
gatewaySubnet The name of the subnet where Gateway is to be deployed. This must always be named GatewaySubnet.
subnetPrefix The address range in CIDR notation for the first subnet.
gatewaySubnetPrefix The address range in CIDR notation for the Gateway subnet. For ExpressRoute enabled Gateways, this must be minimum of /28.
gatewayPublicIPName The resource name given to the public IP attached to the gateway.
gatewayName The resource name given to the ExpressRoute gateway.
connectionName The resource name given to the Connection which links VNet Gateway to ExpressRoute circuit.
circuitName The name of the ExpressRoute circuit with which the VNet Gateway needs to connect. The Circuit must be already created successfully and must have its circuitProvisioningState property set to 'Enabled', and serviceProviderProvisioningState property set to 'Provisioned'. The Circuit must also have a BGP Peering of type AzurePrivatePeering.
location Location for all resources.

Use the template


New-AzureRmResourceGroupDeployment -Name <deployment-name> -ResourceGroupName <resource-group-name> -TemplateUri
Install and configure Azure PowerShell

Command line

azure config mode arm
azure group deployment create <my-resource-group> <my-deployment-name> --template-uri
Install and Configure the Azure Cross-Platform Command-Line Interface