Quickstart: Een ExpressRoute-circuit maken en wijzigen met behulp van Azure CLI
In deze quickstart wordt beschreven hoe u een Azure ExpressRoute-circuit maakt met behulp van de CLI of opdrachtregelinterface. U leest hier ook hoe u de status controleert, en een circuit bijwerkt, verwijdert of de inrichting ervan ongedaan maakt.
Vereisten
- Bekijk de vereisten en werkstromen voordat u begint met de configuratie.
- Een Azure-account met een actief abonnement. Gratis een account maken
- Installeer de nieuwste versie van de CLI-opdrachten (2.0 of hoger). Zie Azure CLI installeren en Aan de slag met Azure CLI voor meer informatie over de CLI-opdrachten.
Azure Cloud Shell
Azure host Azure Cloud Shell, een interactieve shell-omgeving die u via uw browser kunt gebruiken. U kunt Bash of PowerShell gebruiken met Cloud Shell om met Azure-services te werken. U kunt de vooraf geïnstalleerde Cloud Shell-opdrachten gebruiken om de code in dit artikel uit te voeren zonder dat u iets hoeft te installeren in uw lokale omgeving.
Om Azure Cloud Shell op te starten:
| Optie | Voorbeeld/koppeling |
|---|---|
| Selecteer Uitproberen in de rechterbovenhoek van een code- of opdrachtblok. Als u Try It selecteert, wordt de code of opdracht niet automatisch gekopieerd naar Cloud Shell. |  |
| Ga naar https://shell.azure.com, of selecteer de knop Cloud Shell starten om Cloud Shell in uw browser te openen. |  |
| Klik op de knop Cloud Shell in het menu in de balk rechtsboven in de Azure-portal. |  |
Azure Cloud Shell gebruiken:
Start Cloud Shell.
Selecteer de knop Kopiëren op een codeblok (of opdrachtblok) om de code of opdracht te kopiëren.
Plak de code of opdracht in de Cloud Shell-sessie door Ctrl+Shift+V in Windows en Linux te selecteren of door Cmd+Shift+V te selecteren in macOS.
Selecteer Enter om de code of opdracht uit te voeren.
Een ExpressRoute-circuit maken en inrichten
Aanmelden bij uw Azure-account en uw abonnement selecteren
Meld u aan bij uw Azure-account om de configuratie te starten. Als u Cloud Shell Try It gebruikt, wordt u automatisch aangemeld. Gebruik de volgende voorbeelden als hulp bij het maken van verbinding:
az login
Controleer de abonnementen voor het account.
az account list
Selecteer het abonnement waarvoor u een ExpressRoute-circuit wilt maken.
az account set --subscription "<subscription ID>"
De lijst met ondersteunde providers, locaties en bandbreedten ophalen
U kunt pas een ExpressRoute-circuit maken als u beschikt over de lijst met ondersteunde connectiviteitsproviders, locaties en bandbreedte-opties. De CLI-opdracht az network express-route list-service-providers retourneert deze informatie, die u in latere stappen gebruikt:
az network express-route list-service-providers
Het antwoord is vergelijkbaar met het volgende voorbeeld:
[
{
"bandwidthsOffered": [
{
"offerName": "50Mbps",
"valueInMbps": 50
},
{
"offerName": "100Mbps",
"valueInMbps": 100
},
{
"offerName": "200Mbps",
"valueInMbps": 200
},
{
"offerName": "500Mbps",
"valueInMbps": 500
},
{
"offerName": "1Gbps",
"valueInMbps": 1000
},
{
"offerName": "2Gbps",
"valueInMbps": 2000
},
{
"offerName": "5Gbps",
"valueInMbps": 5000
},
{
"offerName": "10Gbps",
"valueInMbps": 10000
}
],
"id": "/subscriptions//resourceGroups//providers/Microsoft.Network/expressRouteServiceProviders/",
"location": null,
"name": "AARNet",
"peeringLocations": [
"Melbourne",
"Sydney"
],
"provisioningState": "Succeeded",
"resourceGroup": "",
"tags": null,
"type": "Microsoft.Network/expressRouteServiceProviders"
},
Controleer het antwoord om te zien of uw connectiviteitsprovider wordt vermeld. Noteer de volgende informatie die u nodig hebt wanneer u een circuit maakt:
- Naam
- PeeringLocations
- BandwidthsOffered
U bent nu klaar om een ExpressRoute-circuit te maken.
Een ExpressRoute-circuit maken
Belangrijk
Vanaf het moment dat een servicesleutel is uitgegeven, worden er kosten voor een ExpressRoute-circuit in rekening gebracht. Voer deze bewerking uit wanneer de connectiviteitsprovider klaar is om het circuit in te richten.
Als u nog geen resourcegroep hebt, moet u er een maken voordat u het ExpressRoute-circuit maakt. U kunt een resourcegroep maken door de volgende opdracht uit te voeren:
az group create -n ExpressRouteResourceGroup -l "West US"
In het volgende voorbeeld ziet u hoe u een ExpressRoute-circuit van 200 Mbps maakt met behulp van Equinix in Silicon Valley. Als u een andere provider en andere instellingen gebruikt, vervangt u de gegevens uit het voorbeeld door uw gegevens wanneer u uw aanvraag verstuurt.
Zorg ervoor dat u de juiste SKU-categorie en SKU-familie opgeeft:
- De SKU-categorie bepaalt of een ExpressRoute-circuit Local, Standard of Premium is. U kunt Local, *Standard of Premium opgeven.
- De SKU-familie bepaalt het type facturering. U kunt MeteredData opgeven voor een data-abonnement met een datalimiet en UnlimitedData voor een onbeperkt data-abonnement. U kunt het type facturering wijzigen van MeteredData in UnlimitedData, maar niet van UnlimitedData in MeteredData. Een Local circuit kan alleen UnlimitedData zijn.
Vanaf het moment dat een servicesleutel is uitgegeven, worden er kosten voor een ExpressRoute-circuit in rekening gebracht. Het volgende voorbeeld is een aanvraag voor een nieuwe servicesleutel:
az network express-route create --bandwidth 200 -n MyCircuit --peering-location "Silicon Valley" -g ExpressRouteResourceGroup --provider "Equinix" -l "West US" --sku-family MeteredData --sku-tier Standard
Het antwoord bevat de servicesleutel.
Alle ExpressRoute-circuits opvragen
Als u een lijst wilt weergeven met alle ExpressRoute-circuits die u hebt gemaakt, voert u de opdracht az network express-route list uit. U kunt deze informatie op elk gewenst moment ophalen met behulp van deze opdracht. Als u alle circuits wilt weergeven, doet u de aanroep zonder parameters.
az network express-route list
Uw servicesleutel wordt vermeld in het veld ServiceKey van het antwoord.
"allowClassicOperations": false,
"authorizations": [],
"circuitProvisioningState": "Enabled",
"etag": "W/\"1262c492-ffef-4a63-95a8-a6002736b8c4\"",
"gatewayManagerEtag": null,
"id": "/subscriptions/81ab786c-56eb-4a4d-bb5f-f60329772466/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/MyCircuit",
"location": "westus",
"name": "MyCircuit",
"peerings": [],
"provisioningState": "Succeeded",
"resourceGroup": "ExpressRouteResourceGroup",
"serviceKey": "1d05cf70-1db5-419f-ad86-1ca62c3c125b",
"serviceProviderNotes": null,
"serviceProviderProperties": {
"bandwidthInMbps": 200,
"peeringLocation": "Silicon Valley",
"serviceProviderName": "Equinix"
},
"serviceProviderProvisioningState": "NotProvisioned",
"sku": {
"family": "UnlimitedData",
"name": "Standard_MeteredData",
"tier": "Standard"
},
"tags": null,
"type": "Microsoft.Network/expressRouteCircuits]
U kunt gedetailleerde beschrijvingen van alle parameters opvragen door de opdracht uit te voeren met de parameter -h.
az network express-route list -h
De servicesleutel voor inrichting verzenden naar de connectiviteitsprovider
'ServiceProviderProvisioningState' bevat informatie over de huidige status van de inrichting aan de zijde van de serviceprovider. 'circuitProvisioningState' vermeldt de status aan de zijde van Microsoft. Zie voor meer informatie het artikel over workflows.
Wanneer u een nieuw ExpressRoute-circuit maakt, heeft het circuit de volgende status:
"serviceProviderProvisioningState": "NotProvisioned"
"circuitProvisioningState": "Enabled"
Wanneer de connectiviteitsprovider bezig is met het inschakelen van uw circuit, verandert de status van het circuit in:
"serviceProviderProvisioningState": "Provisioning"
"circuitProvisioningState": "Enabled"
Als u het ExpressRoute-circuit wilt gebruiken, moet het de volgende status hebben:
"serviceProviderProvisioningState": "Provisioned"
"circuitProvisioningState": "Enabled
Controleer regelmatig de circuitstatus en de status van de circuitsleutel
Als u de status en de status van de servicesleutel controleert, weet u wanneer uw provider uw circuit heeft ingericht. Nadat het circuit is geconfigureerd, wordt ServiceProviderProvisioningState weergegeven als Provisioned, zoals wordt weergegeven in het volgende voorbeeld:
az network express-route show --resource-group ExpressRouteResourceGroup --name MyCircuit
Het antwoord is vergelijkbaar met het volgende voorbeeld:
"allowClassicOperations": false,
"authorizations": [],
"circuitProvisioningState": "Enabled",
"etag": "W/\"1262c492-ffef-4a63-95a8-a6002736b8c4\"",
"gatewayManagerEtag": null,
"id": "/subscriptions/81ab786c-56eb-4a4d-bb5f-f60329772466/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/MyCircuit",
"location": "westus",
"name": "MyCircuit",
"peerings": [],
"provisioningState": "Succeeded",
"resourceGroup": "ExpressRouteResourceGroup",
"serviceKey": "1d05cf70-1db5-419f-ad86-1ca62c3c125b",
"serviceProviderNotes": null,
"serviceProviderProperties": {
"bandwidthInMbps": 200,
"peeringLocation": "Silicon Valley",
"serviceProviderName": "Equinix"
},
"serviceProviderProvisioningState": "NotProvisioned",
"sku": {
"family": "UnlimitedData",
"name": "Standard_MeteredData",
"tier": "Standard"
},
"tags": null,
"type": "Microsoft.Network/expressRouteCircuits]
De routeringsconfiguratie maken
Raadpleeg het artikel over de routeringsconfiguratie voor ExpressRoute-circuits voor stapsgewijze instructies over het maken en wijzigen van circuitpeerings.
Belangrijk
Deze instructies zijn alleen van toepassing op circuits die zijn gemaakt met serviceproviders die services met laag-2-connectiviteit aanbieden. Als u gebruikmaakt van een serviceprovider die beheerde laag-3-services aanbiedt (meestal een IP-adres voor VPN, zoals MPLS), wordt de routering voor u geconfigureerd en beheerd via de connectiviteitsprovider.
Een virtueel netwerk koppelen aan een ExpressRoute-circuit
Koppel vervolgens een virtueel netwerk aan een ExpressRoute-circuit. Raadpleeg hiervoor het artikel over het koppelen van virtuele netwerken aan ExpressRoute-circuits.
Een ExpressRoute-circuit wijzigen
U kunt bepaalde eigenschappen van een ExpressRoute-circuit wijzigen zonder dat dit van invloed is op de connectiviteit. U kunt de volgende wijzigingen aanbrengen zonder downtime:
- U kunt een Premium-invoegtoepassing in- of uitschakelen voor uw ExpressRoute-circuit.
- U kunt de bandbreedte van uw ExpressRoute-circuit vergroten, op voorwaarde dat er capaciteit beschikbaar is op de poort. Het verminderen van de bandbreedte van een circuit wordt daarentegen niet ondersteund.
- U kunt het verbruiksabonnement wijzigen van Datalimiet in Onbeperkte data. Het verbruiksabonnement wijzigen van Onbeperkte data in Datalimiet wordt echter niet ondersteund.
- U kunt klassieke bewerkingen toestaan in- en uitschakelen.
Zie de Veelgestelde vragen over ExpressRoute voor meer informatie over limieten en beperkingen.
Premium-invoegtoepassing voor ExpressRoute inschakelen
U kunt de ExpressRoute Premium-invoegtoepassing inschakelen voor uw bestaande circuit met behulp van de volgende opdracht:
az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Premium
De functies van de ExpressRoute Premium-invoegtoepassing zijn nu ingeschakeld voor het circuit. U wordt gefactureerd voor de mogelijkheden van de Premium-invoegtoepassing zodra de opdracht is uitgevoerd.
Premium-invoegtoepassing voor ExpressRoute uitschakelen
Belangrijk
Deze bewerking kan mislukken als u resources gebruikt die groter zijn dan wat is toegestaan voor het Standard-circuit.
Voordat u de ExpressRoute Premium-invoegtoepassing uitschakelt, is het belangrijk dat u de volgende criteria begrijpt:
- Voordat u een downgrade uitvoert van Premium naar Standard, moet u ervoor zorgen dat het aantal virtuele netwerken dat is gekoppeld aan het circuit, kleiner is dan 10. Als u dat niet doet, mislukt de aanvraag en wordt u gefactureerd tegen Premium-tarieven.
- Alle virtuele netwerken in andere geopolitieke regio's moeten eerst worden ontkoppeld. Als u de koppeling niet verwijdert, mislukt uw updateaanvraag en blijven we u factureren tegen premiumtarieven.
- De routetabel moet kleiner zijn dan 4.000 routes voor persoonlijke peering. Als de grootte van de routetabel groter is dan 4000 routes, wordt de BGP-sessie verwijderd. De BGP-sessie wordt pas hersteld nadat het aantal geadverteerde voorvoegsels minder is dan 4000.
U kunt de ExpressRoute Premium-invoegtoepassing uitschakelen voor het bestaande circuit met behulp van het volgende voorbeeld:
az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Standard
De bandbreedte van het ExpressRoute-circuit bijwerken
Informatie over de ondersteunde bandbreedte-opties voor uw provider vindt u in de Veelgestelde vragen over ExpressRoute. U kunt elke grootte kiezen die groter is dan de grootte van uw bestaande circuit.
Belangrijk
Als er onvoldoende capaciteit is op de bestaande poort, moet u het ExpressRoute-circuit mogelijk opnieuw maken. U kunt het circuit niet upgraden als er geen extra capaciteit beschikbaar is op de betreffende locatie.
Het is niet mogelijk om de bandbreedte van een ExpressRoute-circuit zonder onderbreking te verminderen. Voor het verminderen van de bandbreedte moet u de inrichting van het ExpressRoute-circuit ongedaan maken, en vervolgens een nieuw ExpressRoute-circuit inrichten.
Nadat u hebt bepaald welke grootte u nodig hebt, gebruikt u de volgende opdracht om de grootte van het circuit te wijzigen:
az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --bandwidth 1000
Uw circuit wordt bijgewerkt aan de zijde van Microsoft. Vervolgens moet u contact opnemen met uw connectiviteitsprovider om configuraties aan hun zijde bij te werken met deze wijziging. Nadat u deze melding hebt gedaan, wordt u gefactureerd voor de bijgewerkte bandbreedte-optie.
De SKU wijzigen van Datalimiet in Onbeperkte data
U kunt de SKU van een ExpressRoute-circuit wijzigen met behulp van het volgende voorbeeld:
az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-family UnlimitedData
De toegang tot de klassieke omgeving en de Resource Manager-omgeving beheren
Lees de instructies in het artikel over het verplaatsen van ExpressRoute-circuits van het klassieke naar het Resource Manager-implementatiemodel.
De inrichting van een ExpressRoute-circuit ongedaan maken
Als u het inrichten van een ExpressRoute-circuit ongedaan wilt maken om het circuit te verwijderen, is het belangrijk dat u de volgende criteria begrijpt:
- Alle virtuele netwerken moeten worden losgekoppeld van het ExpressRoute-circuit. Als deze bewerking mislukt, controleert u of er virtuele netwerken zijn gekoppeld aan het circuit.
- Als de serviceprovider van het circuit de inrichtingsstatus Inrichten of Ingericht heeft, moet u contact opnemen met de serviceprovider om de inrichting van het circuit aan hun zijde ongedaan te maken. We blijven resources reserveren en kosten in rekening brengen, totdat de serviceprovider de inrichting van het circuit helemaal ongedaan heeft gemaakt en ons op de hoogte heeft gesteld.
- Als de serviceprovider dit heeft gedaan (de inrichtingsstatus bij de serviceprovider is ingesteld op NotProvisioned), kunt u het circuit verwijderen. De facturering voor de circuitstop.
Resources opschonen
U kunt uw ExpressRoute-circuit verwijderen door de volgende opdracht uit te voeren:
az network express-route delete -n MyCircuit -g ExpressRouteResourceGroup
Volgende stappen
Nadat u het circuit hebt gemaakt en het circuit is ingericht bij uw provider, gaat u verder met de volgende stap om de peering te configureren: