Snabb start: skapa och ändra en ExpressRoute-krets med Azure CLIQuickstart: Create and modify an ExpressRoute circuit using Azure CLI

I den här snabb starten beskrivs hur du skapar en Azure ExpressRoute-krets med hjälp av kommando rads gränssnittet (CLI).This quickstart describes how to create an Azure ExpressRoute circuit by using the Command Line Interface (CLI). Den här artikeln visar också hur du kontrollerar status, uppdaterar eller tar bort och avetablerar en krets.This article also shows you how to check the status, update, or delete and deprovision a circuit.

FörutsättningarPrerequisites

Använda Azure Cloud ShellUse Azure Cloud Shell

Azure är värd för Azure Cloud Shell, en interaktiv gränssnittsmiljö som du kan använda via webbläsaren.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Du kan använda antingen Bash eller PowerShell med Cloud Shell för att arbeta med Azure-tjänster.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. Du kan använda förinstallerade Cloud Shell-kommandon för att köra koden i den här artikeln utan att behöva installera något i din lokala miljö.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Så här startar du Azure Cloud Shell:To start Azure Cloud Shell:

AlternativOption Exempel/länkExample/Link
Välj Prova i det övre högra hörnet av ett kodblock.Select Try It in the upper-right corner of a code block. Om du väljer Prova kopieras koden inte automatiskt till Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Exempel på Prova för Azure Cloud Shell
Gå till https://shell.azure.com eller Välj knappen Starta Cloud Shell för att öppna Cloud Shell i webbläsaren.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. Starta Cloud Shell i ett nytt fönsterLaunch Cloud Shell in a new window
Välj knappen Cloud Shell på menyn längst upp till höger i Azure-portalen.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Cloud Shell-knappen i Azure Portal

Så här kör du koden i den här artikeln i Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Starta Cloud Shell.Start Cloud Shell.

  2. Kopiera koden genom att klicka på knappen Kopiera på ett kodblock.Select the Copy button on a code block to copy the code.

  3. Klistra in koden i Cloud Shell-sessionen genom att välja Ctrl+Skift+V på Windows och Linux eller genom att välja Cmd+Skift+V på macOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Välj Retur för att köra koden.Select Enter to run the code.

Skapa och etablera en ExpressRoute-kretsCreate and provision an ExpressRoute circuit

Logga in på ditt Azure-konto och välj din prenumerationSign in to your Azure account and select your subscription

Logga in på ditt Azure-konto för att påbörja konfigurationen.To begin your configuration, sign in to your Azure account. Om du använder Cloud Shell "testa" är du inloggad automatiskt.If you use the Cloud Shell "Try It", you're signed in automatically. Använd följande exempel för att ansluta:Use the following examples to help you connect:

az login

Kontrollera prenumerationerna för kontot.Check the subscriptions for the account.

az account list

Välj den prenumeration som du vill skapa en ExpressRoute-krets för.Select the subscription for which you want to create an ExpressRoute circuit.

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

Hämta listan över providers, platser och bandbredder som stödsGet the list of supported providers, locations, and bandwidths

Innan du skapar en ExpressRoute-krets behöver du en lista över anslutnings leverantörer, platser och bandbredds alternativ som stöds.Before you create an ExpressRoute circuit, you need the list of supported connectivity providers, locations, and bandwidth options. CLI-kommandot az network express-route list-service-providers returnerar den här informationen, som du kommer att använda i senare steg: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

Svaret liknar följande exempel: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"
  },

Kontrol lera svaret för att se om din anslutnings leverantör visas.Check the response to see if your connectivity provider is listed. Anteckna följande information som du behöver när du skapar en krets:Make a note of the following information, which you'll need when you create a circuit:

  • NameName
  • PeeringLocationsPeeringLocations
  • BandwidthsOfferedBandwidthsOffered

Nu är du redo att skapa en ExpressRoute-krets.You're now ready to create an ExpressRoute circuit.

Skapa en ExpressRoute-kretsCreate an ExpressRoute circuit

Viktigt

Din ExpressRoute-krets debiteras från den tidpunkt då en tjänst nyckel utfärdas.Your ExpressRoute circuit is billed from the moment a service key is issued. Utför den här åtgärden när anslutnings leverantören är redo att etablera kretsen.Perform this operation when the connectivity provider is ready to provision the circuit.

Om du inte redan har en resurs grupp måste du skapa en innan du skapar din ExpressRoute-krets.If you don't already have a resource group, you must create one before you create your ExpressRoute circuit. Du kan skapa en resurs grupp genom att köra följande kommando:You can create a resource group by running the following command:

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

I följande exempel visas hur du skapar en 200-Mbit/s ExpressRoute-krets via Equinix i Silicon dal.The following example shows how to create a 200-Mbps ExpressRoute circuit through Equinix in Silicon Valley. Om du använder en annan provider och andra inställningar ersätter du den informationen när du gör din begäran.If you're using a different provider and different settings, replace that information when you make your request.

Se till att du anger rätt SKU-nivå och SKU-serien:Make sure that you specify the correct SKU tier and SKU family:

  • SKU-nivån avgör om en ExpressRoute-krets är lokal, standard eller Premium.SKU tier determines whether an ExpressRoute circuit is Local, Standard, or Premium. Du kan ange lokal, * standard eller Premium.You can specify Local, *Standard, or Premium. Du kan inte ändra SKU: n från Standard-/Premium till lokal.You can't change the SKU from Standard/Premium to Local.
  • SKU-serien bestämmer fakturerings typen.SKU family determines the billing type. Du kan ange MeteredData för ett data abonnemang med datapriser och UnlimitedData för ett obegränsat data abonnemang.You can specify MeteredData for a metered data plan and UnlimitedData for an unlimited data plan. Du kan ändra fakturerings typen från MeteredData till UnlimitedData, men du kan inte ändra typen från UnlimitedData till MeteredData.You can change the billing type from MeteredData to UnlimitedData, but you can't change the type from UnlimitedData to MeteredData. En lokal krets är endast UnlimitedData .A Local circuit is UnlimitedData only.

Din ExpressRoute-krets debiteras från den tidpunkt då en tjänst nyckel utfärdas.Your ExpressRoute circuit is billed from the moment a service key is issued. Följande exempel är en begäran om en ny tjänst nyckel: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

Svaret innehåller tjänst nyckeln.The response contains the service key.

Visa en lista över alla ExpressRoute-kretsarList all ExpressRoute circuits

Om du vill hämta en lista över alla ExpressRoute-kretsar som du har skapat kör du az network express-route list kommandot.To get a list of all the ExpressRoute circuits that you created, run the az network express-route list command. Du kan hämta den här informationen när som helst genom att använda det här kommandot.You can retrieve this information at any time by using this command. Om du vill visa alla kretsar gör du ett anrop utan parametrar.To list all circuits, make the call with no parameters.

az network express-route list

Din tjänst nyckel visas i fältet serviceKey i svaret.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]

Du kan få detaljerade beskrivningar av alla parametrar genom att köra kommandot med parametern "-h".You can get detailed descriptions of all the parameters by running the command using the '-h' parameter.

az network express-route list -h

Skicka tjänst nyckeln till din anslutnings leverantör för etableringSend the service key to your connectivity provider for provisioning

"ServiceProviderProvisioningState" innehåller information om det aktuella etablerings läget på tjänstens leverantörs sida.'ServiceProviderProvisioningState' provides information about the current state of provisioning on the service-provider side. Statusen ger tillståndet på Microsoft-sidan.The status provides the state on the Microsoft side. Mer information finns i artikeln om arbets flöden.For more information, see the Workflows article.

När du skapar en ny ExpressRoute-krets är kretsen i följande tillstånd:When you create a new ExpressRoute circuit, the circuit is in the following state:

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

Kretsen ändras till följande tillstånd när anslutnings leverantören för närvarande aktiverar den åt dig:The circuit changes to the following state when the connectivity provider is currently enabling it for you:

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

Om du vill använda ExpressRoute-kretsen måste den vara i följande tillstånd:To use the ExpressRoute circuit, it must be in the following state:

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

Kontrol lera regelbundet status och tillståndet för krets nyckelnPeriodically check the status and the state of the circuit key

Genom att kontrol lera status och tillståndet för tjänst nyckeln kan du se när din-provider har allokerat din krets.Checking the status and the state of the service key will let you know when your provider has provisioned your circuit. När kretsen har kon figurer ATS visas ServiceProviderProvisioningState som etablerad, som du ser i följande exempel: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

Svaret liknar följande exempel: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]

Skapa konfigurationen för routningCreate your routing configuration

Stegvisa instruktioner finns i ExpressRoute-kretsens konfigurations artikel för att skapa och ändra krets-peering.For step-by-step instructions, see the ExpressRoute circuit routing configuration article to create and modify circuit peerings.

Viktigt

Dessa anvisningar gäller endast för kretsar som skapats med tjänst leverantörer som erbjuder Layer 2-anslutningstjänster.These instructions only apply to circuits that are created with service providers that offer layer 2 connectivity services. Om du använder en tjänst leverantör som erbjuder hanterade Layer 3-tjänster (vanligt vis ett IP-VPN, som MPLS) konfigurerar och hanterar din anslutnings leverantör routning åt dig.If you're using a service provider that offers managed layer 3 services (typically an IP VPN, like MPLS), your connectivity provider configures and manages routing for you.

Länka sedan ett virtuellt nätverk till din ExpressRoute-krets.Next, link a virtual network to your ExpressRoute circuit. Använd artikeln Länka virtuella nätverk till ExpressRoute-kretsar .Use the Linking virtual networks to ExpressRoute circuits article.

Ändra en ExpressRoute-kretsModifying an ExpressRoute circuit

Du kan ändra vissa egenskaper för en ExpressRoute-krets utan att påverka anslutningen.You can modify certain properties of an ExpressRoute circuit without impacting connectivity. Du kan göra följande ändringar utan avbrott:You can make the following changes with no downtime:

  • Du kan aktivera eller inaktivera ett ExpressRoute Premium-tillägg för din ExpressRoute-krets.You can enable or disable an ExpressRoute premium add-on for your ExpressRoute circuit. Det finns inte stöd för att ändra SKU: n från Standard/Premium till lokal .Changing the SKU from Standard/Premium to Local isn't supported.
  • Du kan öka bandbredden för din ExpressRoute-krets om det finns tillgänglig kapacitet för porten.You can increase the bandwidth of your ExpressRoute circuit provided there's capacity available on the port. Nedgradering av en kretss bandbredd stöds dock inte.However, downgrading the bandwidth of a circuit isn't supported.
  • Du kan ändra Mät planen från datapriser till obegränsade data.You can change the metering plan from Metered Data to Unlimited Data. Det går dock inte att ändra Mät planen från obegränsade data till datapriser.However, changing the metering plan from Unlimited Data to Metered Data isn't supported.
  • Du kan aktivera och inaktivera Tillåt klassiska åtgärder.You can enable and disable Allow Classic Operations.

Mer information om begränsningar och begränsningar finns i vanliga frågor och svar om ExpressRoute.For more information on limits and limitations, see the ExpressRoute FAQ.

Aktivera ExpressRoute Premium-tilläggetTo enable the ExpressRoute premium add-on

Du kan aktivera ExpressRoute Premium-tillägget för din befintliga krets genom att använda följande kommando: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

Kretsen har nu ExpressRoute Premium-tillägg aktiverade.The circuit now has the ExpressRoute premium add-on features enabled. Vi börjar med att debitera dig för Premium-tilläggs kapaciteten så snart kommandot har körts.We begin billing you for the premium add-on capability as soon as the command has successfully run.

Så här inaktiverar du ExpressRoute Premium-tilläggetTo disable the ExpressRoute premium add-on

Viktigt

Den här åtgärden kan inte utföras om du använder resurser som är större än vad som tillåts för standard kretsen.This operation can fail if you're using resources that are greater than what is permitted for the standard circuit.

Innan du inaktiverar ExpressRoute Premium-tillägget förstår du följande kriterier:Before disabling the ExpressRoute premium add-on, understand the following criteria:

  • Innan du nedgraderar från Premium till standard måste du se till att antalet virtuella nätverk som är länkade till kretsen är mindre än 10.Before you downgrade from premium to standard, you must ensure that the number of virtual networks that are linked to the circuit is less than 10. Om du inte gör det Miss lyckas din uppdateringsbegäran och vi debiteras till Premium priser.If you don't, your update request fails, and we bill you at premium rates.
  • Alla virtuella nätverk i andra politiska regioner måste först avbrytas.All virtual networks in other geopolitical regions must be first unlinked. Om du inte tar bort länken kommer din uppdateringsbegäran att Miss beta och vi fortsätter att fakturera dig till Premium-priser.If you don't remove the link, your update request will fail and we continue to bill you at premium rates.
  • Routningstabellen måste vara mindre än 4 000 vägar för privat peering.Your route table must be less than 4,000 routes for private peering. Om din väg tabell storlek är större än 4 000 vägar tas BGP-sessionen bort.If your route table size is greater than 4,000 routes, the BGP session will drop. BGP-sessionen aktive ras inte igen förrän antalet annonserade prefix är under 4 000.The BGP session won't be re-enabled until the number of advertised prefixes is under 4,000.

Du kan inaktivera ExpressRoute Premium-tillägget för den befintliga kretsen med hjälp av följande exempel: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

Så här uppdaterar du ExpressRoute-kretsens bandbreddTo update the ExpressRoute circuit bandwidth

För de bandbredds alternativ som stöds för din Provider, se vanliga frågor och svar om ExpressRoute.For the supported bandwidth options for your provider, check the ExpressRoute FAQ. Du kan välja valfri storlek som är större än den befintliga kretsens storlek.You can pick any size greater than the size of your existing circuit.

Viktigt

Om det finns otillräcklig kapacitet på den befintliga porten kan du behöva återskapa ExpressRoute-kretsen.If there is inadequate capacity on the existing port, you may have to recreate the ExpressRoute circuit. Du kan inte uppgradera kretsen om det inte finns någon ytterligare kapacitet tillgänglig på den platsen.You cannot upgrade the circuit if there is no additional capacity available at that location.

Du kan inte minska bandbredden för en ExpressRoute-krets utan avbrott.You cannot reduce the bandwidth of an ExpressRoute circuit without disruption. Med degradering av bandbredd måste du avetablera ExpressRoute-kretsen och sedan etablera om en ny ExpressRoute-krets.Downgrading bandwidth requires you to deprovision the ExpressRoute circuit, and then reprovision a new ExpressRoute circuit.

När du har bestämt vilken storlek du behöver använder du följande kommando för att ändra storlek på kretsen: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

Din krets kommer att uppgraderas på Microsoft-sidan.Your circuit will be upgraded on the Microsoft side. Sedan måste du kontakta din anslutnings leverantör för att uppdatera konfigurationerna på sidan för att matcha den här ändringen.Next, you must contact your connectivity provider to update configurations on their side to match this change. När du har gjort den här aviseringen börjar vi debitera dig för alternativet uppdaterad bandbredd.After you make this notification, we begin billing you for the updated bandwidth option.

Flytta SKU: n från avgiftsbelagd till obegränsadTo move the SKU from metered to unlimited

Du kan ändra SKU: n för en ExpressRoute-krets med hjälp av följande exempel: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

Så här kontrollerar du åtkomsten till de klassiska och Resource Manager-miljöernaTo control access to the classic and Resource Manager environments

Läs anvisningarna i Flytta ExpressRoute-kretsar från den klassiska distributions modellen till Resource Manager.Review the instructions in Move ExpressRoute circuits from the classic to the Resource Manager deployment model.

Avetablera en ExpressRoute-kretsDeprovisioning an ExpressRoute circuit

För att avetablera och ta bort en ExpressRoute-krets, se till att du förstår följande kriterier:To deprovision and delete an ExpressRoute circuit, make sure you understand the following criteria:

  • Alla virtuella nätverk måste tas bort från ExpressRoute-kretsen.All virtual networks must be unlinked from the ExpressRoute circuit. Om den här åtgärden Miss lyckas kontrollerar du om det finns några virtuella nätverk som är länkade till kretsen.If this operation fails, check to see if any virtual networks are linked to the circuit.
  • Om etablerings statusen för ExpressRoute-kretsen etableras eller etableras måste du arbeta med tjänst leverantören för att avetablera kretsen på sin sida.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. Vi fortsätter att reservera resurser och fakturera dig tills tjänste leverantören har slutfört avetableringen av kretsen och meddelar oss oss.We continue to reserve resources and bill you until the service provider completes deprovisioning the circuit and notifies us.
  • Om tjänste leverantören har avetablerat kretsen som tjänst leverantörens etablerings status är inställt på inte etablerad, kan du ta bort kretsen.If the service provider has deprovisioned the circuit meaning the service provider provisioning state gets set to Not provisioned, you can delete the circuit. Faktureringen för kretsen avbryts sedan.The billing for the circuit will then stop.

Rensa resurserClean up resources

Du kan ta bort ExpressRoute-kretsen genom att köra följande kommando:You can delete your ExpressRoute circuit by running the following command:

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

Nästa stegNext steps

När du har skapat din krets och etablerar den med leverantören fortsätter du till nästa steg för att konfigurera peer koppling:After you create your circuit and provision it with your provider, continue to the next step to configure the peering: