An Azure virtual networking service that provides optimized and automated branch-to-branch connectivity.
Unable to Delete a Site Link within our VPN Sites
We are unable to delete a site link and add a new one under one of our VPN Sites.
Azure Virtual WAN
-
Venkatesan S • 8,235 Reputation points • Microsoft External Staff • Moderator
2026-03-27T17:13:18.1966667+00:00 Hi DanB-8393,
Thanks for reaching out in Microsoft Q&A forum,
You can’t delete a site link from a VPN Site in Azure Virtual WAN if that link is still tied to an active VPN connection, or if it’s the only link left in the site. The portal often hides or grays out the delete option in these cases, even though the CLI can still remove it.
What’s happening
- The link is currently connected to a Virtual Hub’s VPN gateway.
- Azure won’t let you delete a link that’s in use.
- The portal UI doesn’t always expose the “remove link” action clearly.
How to fix it
Step 1 – Disconnect and delete the VPN connection first
Before you can remove the link, you need to break its connection to the hub:
- Go to your Virtual Hub → VPN (Site to site).
- Find the connection using that VPN Site link.
- Disconnect it, then delete the VPN connection entirely.
- Wait 5–10 minutes for Azure to finish cleaning up the connection.
Step 2 – Remove the site link (use CLI if the portal blocks you)
If the portal still won’t let you delete the link, use Azure CLI:
# List existing links and note the index of the one you want to remove az network vpn-site link list \ -g <YourResourceGroup> \ --site-name <YourVpnSiteName> # Remove the specific link by index (0-based) az network vpn-site link remove \ -g <YourResourceGroup> \ --site-name <YourVpnSiteName> \ --index <LinkIndex>Step 3 – Add your new link
Once the old link is gone, you can add the new one:
az network vpn-site link add \ --resource-group <YourResourceGroup> \ --site-name <YourVpnSiteName> \ --name <NewLinkName> \ --ip-address <OnPremPublicIP>Then reconnect the VPN Site to your Virtual Hub as needed.
If it’s still stuck
If the link refuses to delete or stays in a “Deleting” state for more than 30 minutes, the cleanest path is often to:
- Recreate the VPN Site with the correct links.
- Connect the new VPN Site to the hub.
- Delete the old, stuck VPN Site.
Official docs:
- Manage VPN site links (CLI) – Azure Virtual WAN
- Create site-to-site connections using Virtual WAN
- Troubleshoot VPN connection issues – Azure Virtual WAN
Kindly let us know if the above helps or you need further assistance on this issue.
Please “up-vote” wherever the information provided helps you, this can be beneficial to other community members.
-
Venkatesan S • 8,235 Reputation points • Microsoft External Staff • Moderator
2026-03-30T01:36:03.1233333+00:00 Hi DanB-8393,
We haven’t heard back from you regarding our last response and wanted to check if you had the opportunity to review our previous post.
Please “up-vote” if the information helped you. This will help us and others in the community as well.
-
DanB-8393 • 0 Reputation points
2026-03-30T13:28:03.2566667+00:00 Thank you for the information.
We will give it a try.
-
Venkatesan S • 8,235 Reputation points • Microsoft External Staff • Moderator
2026-03-31T05:02:49.7933333+00:00 Hi DanB-8393,
Sure, kindly Let me know if the above helps or you need further assistance on this issue.
-
Venkatesan S • 8,235 Reputation points • Microsoft External Staff • Moderator
2026-04-02T04:11:16.3133333+00:00 Hi DanB-8393,
We haven’t heard back from you regarding our last response and wanted to check if you had the opportunity to review our previous post.
Please “up-vote” if the information helped you. This will help us and others in the community as well.
-
Ganesh Patapati • 11,915 Reputation points • Microsoft External Staff • Moderator
2026-04-02T19:16:28.4633333+00:00 Hello DanB-8393,
- Can you please update us if the action plan provided was helpful?
Should there be any follow-up questions or concerns, please let us know and we shall try to address them.
-
Ganesh Patapati • 11,915 Reputation points • Microsoft External Staff • Moderator
2026-04-03T15:48:51.53+00:00 Hello DanB-8393
I have Initiated a private message with you. Kindly provide the necessary details in the private chat.
-
DanB-8393 • 0 Reputation points
2026-04-03T16:04:31.2866667+00:00 Update - We have not revisited this issue as of yet. I will post if the steps do not work for us.
Thank you
-
Ganesh Patapati • 11,915 Reputation points • Microsoft External Staff • Moderator
2026-04-03T16:07:06.9566667+00:00 Thanks for the update!
Should there be any follow-up questions or concerns, please let us know and we shall try to address them.
-
Ganesh Patapati • 11,915 Reputation points • Microsoft External Staff • Moderator
2026-04-06T09:48:46.97+00:00 Hello DanB-8393
Is there any update on the issue??
Should there be any follow-up questions or concerns, please let us know and we shall try to address them.
Thank you!
Sign in to comment