Maken en aanpassen van een ExpressRoute-circuit met behulp van CLICreate and modify an ExpressRoute circuit using CLI

In dit artikel wordt beschreven hoe u een Azure ExpressRoute-circuit maken met behulp van de opdrachtregelinterface (CLI).This article describes how to create an Azure ExpressRoute circuit by using the Command Line Interface (CLI). In dit artikel leest u ook hoe om te controleren van de status, bijwerken of verwijderen en de inrichting van een circuit ongedaan maken.This article also shows you how to check the status, update, or delete and deprovision a circuit. Als u wilt een andere methode gebruiken om te werken met ExpressRoute-circuits, kunt u het artikel in de volgende lijst:If you want to use a different method to work with ExpressRoute circuits, you can select the article from the following list:

Voordat u begintBefore you begin

Maken en inrichten van een ExpressRoute-circuitCreate and provision an ExpressRoute circuit

1. Meld u aan bij uw Azure-account en selecteer uw abonnement1. Sign in to your Azure account and select your subscription

Als u wilt de configuratie begint, moet u zich aanmelden bij uw Azure-account.To begin your configuration, sign in to your Azure account. Als u het 'Try It' CloudShell gebruikt, bent u aangemeld automatisch.If you use the CloudShell "Try It", you are signed in automatically. Gebruik de volgende voorbeelden kunt u verbinding maken:Use the following examples to help you connect:

az login

Controleer de abonnementen voor het account.Check the subscriptions for the account.

az account list

Selecteer het abonnement waarvoor u wenst te maken van een ExpressRoute-circuit.Select the subscription for which you want to create an ExpressRoute circuit.

az account set --subscription "<subscription ID>"

2. De lijst met ondersteunde providers, locaties en bandbreedten2. Get the list of supported providers, locations, and bandwidths

Voordat u een ExpressRoute-circuit maken, moet u de lijst met ondersteunde connectiviteitsproviders, locaties en bandbreedte-opties.Before you create an ExpressRoute circuit, you need the list of supported connectivity providers, locations, and bandwidth options. De CLI-opdracht az network express-route list-service-providers retourneert deze informatie, die u in latere stappen gebruikt:The CLI command az network express-route list-service-providers returns this information, which you’ll use in later steps:

az network express-route list-service-providers

Het antwoord is vergelijkbaar met het volgende voorbeeld:The response is similar to the following example:

[
  {
    "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 als uw connectiviteitsprovider wordt vermeld.Check the response to see if your connectivity provider is listed. Noteer de volgende informatie, u moet bij het maken van een circuit:Make a note of the following information, which you will need when you create a circuit:

  • NameName
  • PeeringLocationsPeeringLocations
  • BandwidthsOfferedBandwidthsOffered

U bent nu klaar om te maken van een ExpressRoute-circuit.You're now ready to create an ExpressRoute circuit.

3. Een ExpressRoute-circuit maken3. Create an ExpressRoute circuit

Belangrijk

Uw ExpressRoute-circuit wordt in rekening gebracht vanaf het moment dat een servicesleutel wordt uitgegeven. Deze bewerking niet uitvoeren wanneer de connectiviteitsprovider gereed is voor de inrichting van het circuit.

Als u nog een resourcegroep hebt, moet u een maken voordat u uw ExpressRoute-circuit maken.If you don't already have a resource group, you must create one before you create your ExpressRoute circuit. U kunt een resourcegroep maken met de volgende opdracht:You can create a resource group by running the following command:

az group create -n ExpressRouteResourceGroup -l "West US"

Het volgende voorbeeld ziet hoe u een 200 Mbps ExpressRoute-circuit via Equinix in Silicon Valley maakt.The following example shows how to create a 200-Mbps ExpressRoute circuit through Equinix in Silicon Valley. Als u verschillende instellingen en een andere provider gebruikt, vervangt u die informatie wanneer u uw aanvraag indienen.If you're using a different provider and different settings, substitute that information when you make your request.

Zorg ervoor dat u opgeeft dat de juiste SKU-laag en de SKU-serie:Make sure that you specify the correct SKU tier and SKU family:

  • SKU-laag wordt bepaald of een ExpressRoute-standard- of een premium-invoegtoepassing voor ExpressRoute is ingeschakeld.SKU tier determines whether an ExpressRoute standard or an ExpressRoute premium add-on is enabled. U kunt 'Standaard' voor de standard-SKU- of Premium om de premium-invoegtoepassing opgeven.You can specify 'Standard' to get the standard SKU or 'Premium' for the premium add-on.
  • SKU-serie, bepaalt de facturering.SKU family determines the billing type. U kunt 'Metereddata' voor een gecontroleerde data-abonnement en 'Unlimiteddata' opgeven voor een abonnement voor onbeperkt gebruik.You can specify 'Metereddata' for a metered data plan and 'Unlimiteddata' for an unlimited data plan. U kunt de facturering type van 'Metereddata' naar 'Unlimiteddata' wijzigen, maar u kunt het type van 'Unlimiteddata' naar 'Metereddata' niet wijzigen.You can change the billing type from 'Metereddata' to 'Unlimiteddata', but you can't change the type from 'Unlimiteddata' to 'Metereddata'.

Uw ExpressRoute-circuit wordt in rekening gebracht vanaf het moment dat een servicesleutel wordt uitgegeven.Your ExpressRoute circuit is billed from the moment a service key is issued. Het volgende voorbeeld wordt een aanvraag voor een nieuwe servicesleutel:The following example is a request for a new service key:

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 sleutel van de service.The response contains the service key.

4. Lijst van alle ExpressRoute-circuits4. List all ExpressRoute circuits

Uitvoeren als u een lijst met alle ExpressRoute-circuits die u hebt gemaakt, de az network express-route list opdracht.To get a list of all the ExpressRoute circuits that you created, run the az network express-route list command. U kunt deze informatie op elk gewenst moment ophalen met behulp van deze opdracht.You can retrieve this information at any time by using this command. Als u alle circuits, moet u de aanroep zonder parameters.To list all circuits, make the call with no parameters.

az network express-route list

De sleutel van uw service wordt weergegeven in de ServiceKey veld van het antwoord.Your service key is listed in the ServiceKey field of the response.

"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 ophalen door het uitvoeren van de installatieopdracht via de '-h "parameter.You can get detailed descriptions of all the parameters by running the command using the '-h' parameter.

az network express-route list -h

5. De servicesleutel verzenden naar uw connectiviteitsprovider om in te richten5. Send the service key to your connectivity provider for provisioning

'ServiceProviderProvisioningState' bevat informatie over de huidige status van inrichting aan de service-provider.'ServiceProviderProvisioningState' provides information about the current state of provisioning on the service-provider side. De status bevat de status aan de kant van Microsoft.The status provides the state on the Microsoft side. Zie voor meer informatie de werkstromen artikel.For more information, see the Workflows article.

Wanneer u een nieuwe ExpressRoute-circuit maakt, wordt het circuit is in de volgende status:When you create a new ExpressRoute circuit, the circuit is in the following state:

"serviceProviderProvisioningState": "NotProvisioned"
"circuitProvisioningState": "Enabled"

Het circuit gewijzigd in de volgende status hebben de connectiviteitsprovider Bezig inschakelen voor u is:The circuit changes to the following state when the connectivity provider is in the process of enabling it for you:

"serviceProviderProvisioningState": "Provisioning"
"circuitProvisioningState": "Enabled"

Voordat u kunt een ExpressRoute-circuit gebruiken, moet deze de status van de volgende zijn:For you to be able to use an ExpressRoute circuit, it must be in the following state:

"serviceProviderProvisioningState": "Provisioned"
"circuitProvisioningState": "Enabled

6. Controleer regelmatig de status en de status van de sleutel van het circuit6. Periodically check the status and the state of the circuit key

De status en de status van de sleutel van het circuit controleren, laat u weten wanneer uw provider het circuit is ingeschakeld.Checking the status and the state of the circuit key lets you know when your provider has enabled your circuit. Nadat het circuit is geconfigureerd, is 'ServiceProviderProvisioningState' wordt weergegeven als 'Ingericht', zoals wordt weergegeven in het volgende voorbeeld:After the circuit has been configured, 'ServiceProviderProvisioningState' appears as 'Provisioned', as shown in the following example:

az network express-route show --resource-group ExpressRouteResourceGroup --name MyCircuit

Het antwoord is vergelijkbaar met het volgende voorbeeld:The response is similar to the following example:

"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]

7. De configuratie van de routering maken7. Create your routing configuration

Zie voor stapsgewijze instructies, de ExpressRoute-circuit routeringsconfiguratie artikel maken en aanpassen-circuitpeerings.For step-by-step instructions, see the ExpressRoute circuit routing configuration article to create and modify circuit peerings.

Belangrijk

Deze instructies zijn alleen van toepassing op circuits die zijn gemaakt met serviceproviders die services op laag 2-connectiviteit aanbieden. Als u een serviceprovider die beheerde laag-3-services (meestal een IP VPN, zoals MPLS), uw connectiviteitsprovider configureert en beheert routering voor u.

Vervolgens moet u een virtueel netwerk koppelen aan uw ExpressRoute-circuit.Next, link a virtual network to your ExpressRoute circuit. Gebruik de virtuele netwerken koppelen aan ExpressRoute-circuits artikel.Use the Linking virtual networks to ExpressRoute circuits article.

Een ExpressRoute-circuit wijzigenModifying an ExpressRoute circuit

U kunt bepaalde eigenschappen van een ExpressRoute-circuit wijzigen zonder gevolgen voor connectiviteit.You can modify certain properties of an ExpressRoute circuit without impacting connectivity. U kunt de volgende wijzigingen zonder uitvaltijd maken:You can make the following changes with no downtime:

  • U kunt inschakelen of uitschakelen van een premium-invoegtoepassing voor ExpressRoute voor uw ExpressRoute-circuit.You can enable or disable an ExpressRoute premium add-on for your ExpressRoute circuit.
  • U kunt de bandbreedte van uw ExpressRoute-circuit vergroten, mits er capaciteit beschikbaar is op de poort.You can increase the bandwidth of your ExpressRoute circuit provided there is capacity available on the port. Het downgraden van de bandbreedte van een circuit wordt echter niet ondersteund.However, downgrading the bandwidth of a circuit is not supported.
  • U kunt de softwarelicentiecontrole abonnement wijzigen van naar gebruik voor onbeperkte gegevens.You can change the metering plan from Metered Data to Unlimited Data. Echter, het wijzigen van de softwarelicentiecontrole plan van onbeperkte gegevens naar naar gebruik wordt niet ondersteund.However, changing the metering plan from Unlimited Data to Metered Data is not supported.
  • U kunt inschakelen en uitschakelen klassieke bewerkingen toestaan.You can enable and disable Allow Classic Operations.

Zie voor meer informatie over limieten en beperkingen, de Veelgestelde vragen over ExpressRoute.For more information on limits and limitations, see the ExpressRoute FAQ.

De add-on ExpressRoute premium inschakelenTo enable the ExpressRoute premium add-on

U kunt de invoegtoepassing ExpressRoute premium inschakelen voor uw bestaande circuit met behulp van de volgende opdracht uit:You can enable the ExpressRoute premium add-on for your existing circuit by using the following command:

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Premium

Het circuit heeft nu de ExpressRoute premium-invoegtoepassing-functies ingeschakeld.The circuit now has the ExpressRoute premium add-on features enabled. We beginnen facturering voor de mogelijkheid van premium-invoegtoepassing zodra de opdracht is uitgevoerd.We begin billing you for the premium add-on capability as soon as the command has successfully run.

Om uit te schakelen van de premium-invoegtoepassing voor ExpressRouteTo disable the ExpressRoute premium add-on

Belangrijk

Met deze bewerking kan mislukken als u resources die groter zijn dan wat is toegestaan voor de standard-circuit.

Voordat u de invoegtoepassing ExpressRoute premium uitschakelt, begrijpt u de volgende criteria:Before disabling the ExpressRoute premium add-on, understand the following criteria:

  • Voordat u een downgrade van premium naar standard uitvoeren, moet u ervoor zorgen dat er minder dan 10 virtuele netwerken die zijn gekoppeld aan het circuit.Before you downgrade from premium to standard, you must make sure that you have fewer than 10 virtual networks linked to the circuit. Als u meer dan 10 hebt, uw aanvraag voor bijwerken is mislukt en wij factureren u premium-tarieven.If you have more than 10, your update request fails, and we bill you at premium rates.
  • U moet alle virtuele netwerken in andere geopolitieke regio's ontkoppelen.You must unlink all virtual networks in other geopolitical regions. Als u uw virtuele netwerken niet ontkoppelt, mislukt de updateaanvraag en wij factureren u premium-tarief.If you don't unlink all your virtual networks, your update request fails and we bill you at premium rates.
  • De routetabel moet minder dan 4000 routes voor persoonlijke peering.Your route table must be less than 4,000 routes for private peering. Als de grootte van uw route-table groter dan 4000 routes is, komt de BGP-sessie.If your route table size is greater than 4,000 routes, the BGP session drops. De sessie wordt niet totdat het aantal geadverteerde voorvoegsels lager dan 4000 is worden ingeschakeld.The session won't be reenabled until the number of advertised prefixes is below 4,000.

U kunt de ExpressRoute premium-invoegtoepassing voor de bestaande circuit uitschakelen met behulp van het volgende voorbeeld:You can disable the ExpressRoute premium add-on for the existing circuit by using the following example:

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Standard

Bijwerken van de bandbreedte van het ExpressRoute-circuitTo update the ExpressRoute circuit bandwidth

Voor de ondersteunde bandbreedte-opties voor uw provider, Controleer de Veelgestelde vragen over ExpressRoute.For the supported bandwidth options for your provider, check the ExpressRoute FAQ. U kunt de grootte die groter is dan de grootte van uw bestaande circuit kiezen.You can pick any size greater than the size of your existing circuit.

Belangrijk

Als er onvoldoende capaciteit op de bestaande poort, is het mogelijk om het ExpressRoute-circuit opnieuw te maken. U kunt het circuit niet bijwerken als er geen extra capaciteit beschikbaar is op die locatie.

U kunt de bandbreedte van een ExpressRoute-circuit zonder onderbreking niet reduceren. Het downgraden van bandbreedte, moet u de inrichting van het ExpressRoute-circuit ongedaan maken en vervolgens opnieuw inrichten van een nieuwe ExpressRoute-circuit.

Nadat u de grootte die u nodig hebt, gebruikt u de volgende opdracht om het formaat van uw circuit te bepalen:After you decide the size you need, use the following command to resize your circuit:

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --bandwidth 1000

Uw circuit wordt bepaald door de grootte aan de kant van Microsoft.Your circuit is sized up on the Microsoft side. U kunt vervolgens moet contact opnemen met uw connectiviteitsprovider voor het bijwerken van configuraties op hun kant zodat deze overeenkomt met deze wijziging.Next, you must contact your connectivity provider to update configurations on their side to match this change. Nadat u deze melding, beginnen we u facturering voor de bijgewerkte bandbreedte-optie.After you make this notification, we begin billing you for the updated bandwidth option.

Voor het verplaatsen van de SKU van naar gebruik in onbeperktTo move the SKU from metered to unlimited

U kunt de SKU van een ExpressRoute-circuit wijzigen met behulp van het volgende voorbeeld:You can change the SKU of an ExpressRoute circuit by using the following example:

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-family UnlimitedData

Voor het beheren van toegang tot het klassieke en Resource Manager-omgevingenTo control access to the classic and Resource Manager environments

Lees de instructies in verplaatsen ExpressRoute-circuits van het klassieke naar het Resource Manager-implementatiemodel.Review the instructions in Move ExpressRoute circuits from the classic to the Resource Manager deployment model.

Opheffen van inrichting en het verwijderen van een ExpressRoute-circuitDeprovisioning and deleting an ExpressRoute circuit

Voor inrichting ongedaan maken en verwijderen van een ExpressRoute-circuit, zorg ervoor dat de volgende criteria:To deprovision and delete an ExpressRoute circuit, make sure you understand the following criteria:

  • U moet alle virtuele netwerken loskoppelen van het ExpressRoute-circuit.You must unlink all virtual networks from the ExpressRoute circuit. Als deze bewerking is mislukt, controleert u het zien als alle virtuele netwerken zijn gekoppeld aan het circuit.If this operation fails, check to see if any virtual networks are linked to the circuit.
  • Als het ExpressRoute-circuit serviceprovider-Inrichtingsstatus Provisioning of ingerichte, moet u werken met uw serviceprovider inrichting ongedaan maken van het circuit aan hun kant.If the ExpressRoute circuit service provider provisioning state is Provisioning or Provisioned, you must work with your service provider to deprovision the circuit on their side. We blijven reserveer resources en factureren u totdat de service-provider is voltooid ongedaan maken van inrichting van het circuit en ons wordt geïnformeerd.We continue to reserve resources and bill you until the service provider completes deprovisioning the circuit and notifies us.
  • Als de service-provider de inrichting van het circuit is beëindigd, kunt u het circuit verwijderen.You can delete the circuit if the service provider has deprovisioned the circuit. Wanneer de inrichting van een circuit is beëindigd, de serviceprovider Inrichtingsstatus is ingesteld op niet ingericht.When a circuit is deprovisioned, the service provider provisioning state is set to Not provisioned. Hiermee wordt ook de facturering voor het circuit gestopt.This stops billing for the circuit.

U kunt uw ExpressRoute-circuit verwijderen door de volgende opdracht uit:You can delete your ExpressRoute circuit by running the following command:

az network express-route delete  -n MyCircuit -g ExpressRouteResourceGroup

Volgende stappenNext steps

Nadat u uw circuit hebt gemaakt, zorg er dan voor dat u de volgende taken uitvoeren:After you create your circuit, make sure that you do the following tasks: