How to convert your legacy ExpressRoute gateway connections

ExpressRoute gateways created or connected to circuits before 2017 have limitations that affect performance. This guide provides step-by-step instructions to migrate from legacy gateway connections. These limitations include restricted bandwidth, inability to upgrade to higher bandwidth SKUs, and inability to migrate to zone-redundant gateways. Converting to newer connections is recommended to avoid lower throughput and potential connectivity loss.

To begin the conversion, you need to delete all existing connections associated with the identified gateway.

  1. Sign in to the Azure portal.

  2. Navigate to the virtual network gateway with legacy connections.

  3. Identify and delete all existing connections. If you have multiple connections, delete each one individually, ensuring the previous connection is fully deleted before proceeding to the next.

    Screenshot of deleting ExpressRoute gateway connections.

Important

Ensure all connections are removed before recreating new connections.

For more information on how to delete connections, see Link a virtual network to ExpressRoute circuits (Portal, PowerShell, and CLI).

Recreate connections

After deleting the connections, you can proceed to recreate them.

  1. Create new connections from the ExpressRoute virtual network gateway.

    Screenshot of adding a ExpressRoute gateway connections.

  2. Configure the new ExpressRoute connections based on the resiliency model of your previous connections.

    Screenshot of creating ExpressRoute gateway connections.

  3. Validate the new connections to ensure they're functioning correctly. Perform tests to verify that the connections are established and traffic is flowing as expected.

    Screenshot of validating new ExpressRoute gateway connections.

For more information on how to create connections, see Link a virtual network to ExpressRoute circuits (Portal, PowerShell, and CLI).

Note

ExpressRoute gateway connections that aren't converted by February 28, 2025, might experience potential connectivity loss.

Next steps

To learn more about ExpressRoute redundant gateways, see About zone redundant virtual network gateway.