
Inspect the ExpressRoute circuit with PowerShell
Run Get-AzExpressRouteCircuit and specify the resource group and circuit name:Key fields to check
Use the table below to quickly identify which fields indicate healthy provisioning and what to watch for when troubleshooting.| Field | What it means | Expected value / notes |
|---|---|---|
| ProvisioningState | Azure resource provisioning status | Succeeded — Azure-side deployment succeeded |
| CircuitProvisioningState | Circuit enabled/disabled in Azure | Enabled — circuit is active in Azure |
| ServiceProviderProvisioningState | Provider-side provisioning | Provisioned — provider has completed their work |
| ServiceKey | Unique key given to provider to link their order to your circuit | Present and kept private — provider needs this to provision |
| Peerings / Authorizations | Configured peerings and any delegated authorizations | Expected peerings should appear (e.g., AzurePrivatePeering, MicrosoftPeering) |
If any of these states are unexpected (for example ProvisioningState = Failed, CircuitProvisioningState = Disabled, or ServiceProviderProvisioningState = NotProvisioned), the issue is likely at the provisioning stage or with the service provider. Open a support ticket with your provider and verify any required provisioning steps or outstanding actions on their side.
Troubleshooting next steps
-
Confirm provisioning is complete:
- ProvisioningState = Succeeded
- CircuitProvisioningState = Enabled
- ServiceProviderProvisioningState = Provisioned
-
If provisioning looks correct but connectivity fails, check:
- Peerings configuration (ensure Azure, private, or Microsoft peerings are present and configured)
- BGP status and neighbor sessions (see BGP overview)
- Route filters and advertised prefixes (verify route filter configuration)
- Local network gateway settings and on-premises configuration
-
Use the Azure portal as an alternative:
- Open the ExpressRoute circuit in the Azure portal and review the Overview and Provisioning / Service Provider sections for current statuses and any provider notes.
Links and references
- Azure PowerShell: https://learn.microsoft.com/powershell/azure/
- ExpressRoute overview: https://learn.microsoft.com/azure/expressroute/
- BGP overview: https://learn.microsoft.com/azure/virtual-network/virtual-networks-bgp-overview
- ExpressRoute route filters: https://learn.microsoft.com/azure/expressroute/expressroute-route-filters-overview
- Local network gateway: https://learn.microsoft.com/azure/virtual-network/local-network-gateway-overview