Skip to main content
Resetting a failed or stuck ExpressRoute circuit by reapplying its configuration can clear transient provisioning or state issues. The procedure below uses Azure PowerShell to fetch the circuit object and reapply its configuration with Set-AzExpressRouteCircuit.
A presentation slide titled "Resetting a Failed Circuit" with a teal gradient shape and a looped arrow icon on the right. The bottom-left corner shows a small "© Copyright KodeKloud" notice.

​
Why reapply a circuit configuration?

Reapplying the circuit object forces Azure to reconcile the resource state and can resolve issues where the circuit shows failed, provisioning, or unknown states due to transient faults. This approach is non-destructive (it does not change your explicit configuration), but it triggers reconfiguration on Azure’s side.

​
Prerequisites

RequirementPurposeReference
Az PowerShell moduleRun Azure PowerShell commandshttps://learn.microsoft.com/powershell/azure/install-az-ps
Appropriate RBAC permissionsOwner or Network Contributor on the target subscription/resource grouphttps://learn.microsoft.com/azure/role-based-access-control/overview
Network & service provider coordinationNotify providers if maintenance windows are requiredProvider-specific
Ensure you are signed in with an account that has the required permissions on the subscription containing the ExpressRoute circuit. See the ExpressRoute overview for more context: https://learn.microsoft.com/azure/expressroute/overview

​
Workflow

  1. Authenticate to Azure.
  2. Set the subscription context (if you have multiple subscriptions).
  3. Retrieve the ExpressRoute circuit object.
  4. Reapply the circuit configuration using Set-AzExpressRouteCircuit.
  5. Verify the circuit state after the reset.
Example PowerShell sequence: 
# 1) Authenticate
Connect-AzAccount

# 2) Inspect subscriptions and select the target subscription
Get-AzSubscription
Select-AzSubscription -SubscriptionName "LAB-01"

# 3) Retrieve the ExpressRoute circuit object
$erCircuit = Get-AzExpressRouteCircuit `
    -Name "Lab-ER-Circuit" `
    -ResourceGroupName "Lab-RG"

# Optional: inspect the current state and properties
$erCircuit | Format-List *

# 4) Reapply the configuration to reset the circuit
Set-AzExpressRouteCircuit -ExpressRouteCircuit $erCircuit
After you retrieve the circuit object, inspect its properties to understand the current provisioning and service provider states before and after the reset. Useful commands:
  • $erCircuit | Format-List *
  • Get-AzExpressRouteCircuit -Name "Lab-ER-Circuit" -ResourceGroupName "Lab-RG" | Format-List *

​
Verification

  • Re-run Get-AzExpressRouteCircuit and confirm properties such as ProvisioningState and ServiceProviderProvisioningState have moved to healthy values (e.g., Succeeded/Provisioned).
  • Use Azure Portal or Network Watcher diagnostics if further troubleshooting is required.
  • Coordinate with your service provider for cross-checking the provider-side status.
Resetting a circuit can cause a brief service interruption. Perform this action during a maintenance window when possible, and notify affected teams and your service provider before proceeding.

​
References and further reading

Use the steps above to reapply and verify the ExpressRoute circuit configuration when encountering failed or unknown circuit states.

Watch Video