Creare e modificare un circuito ExpressRoute tramite l'interfaccia della riga di comandoCreate and modify an ExpressRoute circuit using CLI

Questo articolo descrive la procedura di creazione di un circuito di Azure ExpressRoute usando l'interfaccia della riga di comando.This article describes how to create an Azure ExpressRoute circuit by using the Command Line Interface (CLI). Questo articolo descrive anche come controllare lo stato, eseguire l'aggiornamento o effettuare l'eliminazione e il deprovisioning di un circuito.This article also shows you how to check the status, update, or delete and deprovision a circuit. Se si vuole usare un metodo diverso per operare con circuiti ExpressRoute, è possibile selezionare l'articolo appropriato nell'elenco seguente:If you want to use a different method to work with ExpressRoute circuits, you can select the article from the following list:

Prima di iniziareBefore you begin

Creare un circuito ExpressRoute ed eseguirne il provisioningCreate and provision an ExpressRoute circuit

1. Accedere al proprio account Azure e selezionare la sottoscrizione1. Sign in to your Azure account and select your subscription

Per iniziare la configurazione, accedere al proprio account Azure.To begin your configuration, sign in to your Azure account. Per eseguire la connessione, usare gli esempi che seguono:Use the following examples to help you connect:

az login

Controllare le sottoscrizioni per l'account.Check the subscriptions for the account.

az account list

Selezionare la sottoscrizione per la quale si vuole creare un circuito ExpressRoute.Select the subscription for which you want to create an ExpressRoute circuit.

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

2. Ottenere l'elenco dei provider, delle località e delle larghezze di banda supportate2. Get the list of supported providers, locations, and bandwidths

Prima di creare un circuito ExpressRoute, è necessario avere l'elenco delle località, delle opzioni di larghezza di banda e dei provider di connettività supportati.Before you create an ExpressRoute circuit, you need the list of supported connectivity providers, locations, and bandwidth options. Il comando 'az network express-route list-service-providers' dell'interfaccia della riga di comando restituisce queste informazioni, che verranno usate nei passaggi successivi: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

La risposta restituita è simile all'esempio seguente: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"
  },

Controllare la riposta per verificare se è presente il proprio provider di connettività.Check the response to see if your connectivity provider is listed. Prendere nota delle informazioni seguenti, perché saranno necessarie al momento della creazione di un circuito:Make a note of the following information, which you will need when you create a circuit:

  • NomeName
  • PeeringLocationsPeeringLocations
  • BandwidthsOfferedBandwidthsOffered

È ora possibile creare un circuito ExpressRoute.You're now ready to create an ExpressRoute circuit.

3. Creare un circuito ExpressRoute3. Create an ExpressRoute circuit

Importante

Il circuito ExpressRoute viene addebitato dal momento in cui viene emessa una chiave di servizio.Your ExpressRoute circuit is billed from the moment a service key is issued. Eseguire l'operazione quando il provider di connettività è pronto a effettuare il provisioning del circuito.Perform this operation when the connectivity provider is ready to provision the circuit.

Se non si ha già un gruppo di risorse, è necessario crearne uno prima di creare il circuito ExpressRoute.If you don't already have a resource group, you must create one before you create your ExpressRoute circuit. È possibile creare un gruppo di risorse eseguendo il comando seguente:You can create a resource group by running the following command:

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

L'esempio seguente illustra come creare un circuito ExpressRoute a 200 Mbps tramite Equinix nella Silicon Valley.The following example shows how to create a 200-Mbps ExpressRoute circuit through Equinix in Silicon Valley. Se si usa un altro provider e impostazioni diverse, sostituire tali informazioni al momento della richiesta.If you're using a different provider and different settings, substitute that information when you make your request.

Verificare di aver specificato il livello e la famiglia SKU corretti:Make sure that you specify the correct SKU tier and SKU family:

  • Il livello SKU determina se deve essere abilitato il componente aggiuntivo ExpressRoute Standard o Premium.SKU tier determines whether an ExpressRoute standard or an ExpressRoute premium add-on is enabled. È possibile specificare 'Standard' per ottenere lo SKU Standard o 'Premium' per il componente aggiuntivo Premium.You can specify 'Standard' to get the standard SKU or 'Premium' for the premium add-on.
  • La famiglia SKU determina il tipo di fatturazione.SKU family determines the billing type. Specificare 'Metereddata' per un piano dati a consumo e 'Unlimiteddata' per un piano dati senza limiti.You can specify 'Metereddata' for a metered data plan and 'Unlimiteddata' for an unlimited data plan. È possibile modificare il tipo di fatturazione da 'Metereddata' a 'Unlimiteddata', ma non è possibile eseguire il passaggio inverso.You can change the billing type from 'Metereddata' to 'Unlimiteddata', but you can't change the type from 'Unlimiteddata' to 'Metereddata'.

Il circuito ExpressRoute viene addebitato dal momento in cui viene emessa una chiave di servizio.Your ExpressRoute circuit is billed from the moment a service key is issued. Di seguito è riportato un esempio di richiesta di una nuova chiave di servizio: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

La risposta contiene la chiave di servizio.The response contains the service key.

4. Elencare tutti i circuiti ExpressRoute4. List all ExpressRoute circuits

Per ottenere un elenco di tutti i circuiti ExpressRoute creati, eseguire il comando 'az network express-route list'.To get a list of all the ExpressRoute circuits that you created, run the 'az network express-route list' command. È possibile recuperare queste informazioni in qualsiasi momento usando questo comando.You can retrieve this information at any time by using this command. Per ottenere un elenco di tutti i circuiti, effettuare la chiamata senza parametri.To list all circuits, make the call with no parameters.

az network express-route list

La chiave di servizio è indicata nel campo ServiceKey della risposta.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]

È possibile ottenere descrizioni dettagliate di tutti i parametri eseguendo il comando con il parametro '-h'.You can get detailed descriptions of all the parameters by running the command using the '-h' parameter.

az network express-route list -h

5. Inviare la chiave di servizio al provider di connettività per il provisioning5. Send the service key to your connectivity provider for provisioning

'ServiceProviderProvisioningState' offre informazioni sullo stato di provisioning corrente sul lato provider del servizio.'ServiceProviderProvisioningState' provides information about the current state of provisioning on the service-provider side. Le informazioni di stato indicano lo stato sul lato Microsoft.The status provides the state on the Microsoft side. Per altre informazioni, vedere l'articolo sui flussi di lavoro.For more information, see the Workflows article.

Quando si crea un nuovo circuito ExpressRoute, il circuito ha lo stato seguente:When you create a new ExpressRoute circuit, the circuit is in the following state:

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

Il circuito passa allo stato seguente quando è in corso l'abilitazione da parte del provider di connettività:The circuit changes to the following state when the connectivity provider is in the process of enabling it for you:

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

Per poterlo usare, un circuito ExpressRoute deve avere lo stato seguente:For you to be able to use an ExpressRoute circuit, it must be in the following state:

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

6. Controllare periodicamente lo stato e la condizione della chiave del circuito6. Periodically check the status and the state of the circuit key

La verifica dello stato e della condizione della chiave del circuito comunicano all'utente quando il provider ha abilitato il circuito.Checking the status and the state of the circuit key lets you know when your provider has enabled your circuit. Dopo la configurazione del circuito, lo stato di 'ServiceProviderProvisioningState' visualizzato è 'Provisioned', come illustrato nell'esempio seguente: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

La risposta restituita è simile all'esempio seguente: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. Creare la configurazione di routing7. Create your routing configuration

Per istruzioni dettagliate, vedere l'articolo relativo alla configurazione del routing per un circuito ExpressRoute per creare e modificare i peering del circuito.For step-by-step instructions, see the ExpressRoute circuit routing configuration article to create and modify circuit peerings.

Importante

Queste istruzioni si applicano solo ai circuiti creati con provider di servizi che offrono servizi di connettività di livello 2.These instructions only apply to circuits that are created with service providers that offer layer 2 connectivity services. Se si usa un provider di servizi che offre servizi gestiti di livello 3 (di solito una VPN IP, come MPLS), il provider di connettività configura e gestisce il routing per conto dell'utente.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.

Collegare quindi una rete virtuale al circuito ExpressRoute.Next, link a virtual network to your ExpressRoute circuit. Fare riferimento all'articolo Collegare una rete virtuale a un circuito ExpressRoute.Use the Linking virtual networks to ExpressRoute circuits article.

Modifica di un circuito ExpressRouteModifying an ExpressRoute circuit

È possibile modificare determinate proprietà di un circuito ExpressRoute senza conseguenze per la connettività.You can modify certain properties of an ExpressRoute circuit without impacting connectivity. È possibile apportare le modifiche seguenti senza tempi di inattività:You can make the following changes with no downtime:

  • Abilitare o disabilitare un componente aggiuntivo ExpressRoute Premium per il circuito ExpressRoute.You can enable or disable an ExpressRoute premium add-on for your ExpressRoute circuit.
  • Aumentare la larghezza di banda del circuito ExpressRoute, a condizione che sulla porta sia disponibile capacità.You can increase the bandwidth of your ExpressRoute circuit provided there is capacity available on the port. Il downgrade della larghezza di banda di un circuito non è tuttavia supportato.However, downgrading the bandwidth of a circuit is not supported.
  • Modificare il piano di misurazione da Dati a consumo a Dati senza limiti.You can change the metering plan from Metered Data to Unlimited Data. La modifica del piano di misurazione da Dati senza limiti a Dati a consumo non è tuttavia supportata.However, changing the metering plan from Unlimited Data to Metered Data is not supported.
  • È possibile abilitare e disabilitare l'opzione Allow Classic Operations(Consenti operazioni classiche).You can enable and disable Allow Classic Operations.

Per altre informazioni su limiti e limitazioni, vedere Domande frequenti su ExpressRoute.For more information on limits and limitations, see the ExpressRoute FAQ.

Per abilitare il componente aggiuntivo ExpressRoute PremiumTo enable the ExpressRoute premium add-on

È possibile abilitare il componente aggiuntivo ExpressRoute Premium per il circuito esistente usando il comando seguente: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

Le funzionalità del componente aggiuntivo ExpressRoute Premium sono così abilitate nel circuito.The circuit now has the ExpressRoute premium add-on features enabled. La fatturazione della funzionalità del componente aggiuntivo Premium inizia non appena il comando viene eseguito correttamente.We begin billing you for the premium add-on capability as soon as the command has successfully run.

Per disabilitare il componente aggiuntivo ExpressRoute PremiumTo disable the ExpressRoute premium add-on

Importante

Questa operazione può avere esito negativo se si usano più risorse di quelle consentite per il circuito standard.This operation can fail if you're using resources that are greater than what is permitted for the standard circuit.

Prima di disabilitare il componente aggiuntivo ExpressRoute Premium, tenere conto dei criteri seguenti:Before disabling the ExpressRoute premium add-on, understand the following criteria:

  • Prima di effettuare il downgrade da Premium a Standard, è necessario assicurarsi che il numero di reti virtuali collegate al circuito sia minore di 10.Before you downgrade from premium to standard, you must make sure that you have fewer than 10 virtual networks linked to the circuit. Se sono più di 10, la richiesta di aggiornamento avrà esito negativo e verranno fatturate le tariffe Premium.If you have more than 10, your update request fails, and we bill you at premium rates.
  • È necessario scollegare tutte le reti virtuali in altre aree geopolitiche.You must unlink all virtual networks in other geopolitical regions. Se non si scollegano tutte le reti virtuali, la richiesta di aggiornamento avrà esito negativo e verranno fatturate le tariffe Premium.If you don't unlink all your virtual networks, your update request fails and we bill you at premium rates.
  • La tabella di route deve includere meno di 4.000 route per il peering privato.Your route table must be less than 4,000 routes for private peering. Se le dimensioni della tabella di route sono maggiori di 4.000 route, la sessione BGP viene interrotta.If your route table size is greater than 4,000 routes, the BGP session drops. La sessione non potrà essere riabilitata fino a quando il numero di prefissi annunciati non diventa inferiore a 4.000.The session won't be reenabled until the number of advertised prefixes is below 4,000.

È possibile disabilitare il componente aggiuntivo ExpressRoute Premium per il circuito esistente usando l'esempio seguente: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

Per aggiornare la larghezza di banda del circuito ExpressRouteTo update the ExpressRoute circuit bandwidth

Per le opzioni relative alla larghezza di banda supportate per il provider, vedere Domande frequenti su ExpressRoute.For the supported bandwidth options for your provider, check the ExpressRoute FAQ. È possibile scegliere qualsiasi dimensione maggiore della dimensione del circuito esistente.You can pick any size greater than the size of your existing circuit.

Importante

Se la capacità sulla porta esistente non è sufficiente, potrebbe essere necessario ricreare il circuito ExpressRoute.If there is inadequate capacity on the existing port, you may have to recreate the ExpressRoute circuit. Il circuito non può essere aggiornato se in tale posizione non è disponibile capacità aggiuntiva.You cannot upgrade the circuit if there is no additional capacity available at that location.

Non è possibile ridurre la larghezza di banda di un circuito ExpressRoute senza interruzioni.You cannot reduce the bandwidth of an ExpressRoute circuit without disruption. Il downgrade della larghezza di banda richiede il deprovisioning del circuito ExpressRoute e quindi il provisioning di un nuovo circuito ExpressRoute.Downgrading bandwidth requires you to deprovision the ExpressRoute circuit, and then reprovision a new ExpressRoute circuit.

Una volta stabilite le dimensioni necessarie, usare il comando seguente per ridimensionare il circuito: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

Il circuito viene ridimensionato su lato di competenza di Microsoft.Your circuit is sized up on the Microsoft side. Sarà poi necessario contattare il provider di connettività perché aggiorni le configurazioni corrispondenti in base a questa modifica.Next, you must contact your connectivity provider to update configurations on their side to match this change. In seguito alla notifica, Microsoft inizia la fatturazione in base all'opzione relativa alla larghezza di banda aggiornata.After you make this notification, we begin billing you for the updated bandwidth option.

Per passare lo SKU dal piano a consumo al piano senza limitiTo move the SKU from metered to unlimited

È possibile modificare lo SKU di un circuito ExpressRoute usando l'esempio seguente: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

Per controllare l'accesso all'ambiente classico e all'ambiente Resource ManagerTo control access to the classic and Resource Manager environments

Vedere le istruzioni contenute in Spostare i circuiti ExpressRoute dal modello di distribuzione classica a quello Resource Manager.Review the instructions in Move ExpressRoute circuits from the classic to the Resource Manager deployment model.

Deprovisioning ed eliminazione di un circuito ExpressRouteDeprovisioning and deleting an ExpressRoute circuit

Per effettuare il deprovisioning e l'eliminazione di un circuito ExpressRoute, assicurarsi di comprendere i criteri seguenti:To deprovision and delete an ExpressRoute circuit, make sure you understand the following criteria:

  • È necessario scollegare tutte le reti virtuali dal circuito ExpressRoute.You must unlink all virtual networks from the ExpressRoute circuit. Se l'operazione non riesce, controllare se sono presenti reti virtuali collegate al circuito.If this operation fails, check to see if any virtual networks are linked to the circuit.
  • Se lo stato di provisioning del provider del servizio del circuito ExpressRoute è Provisioning in corso o Provisioning eseguito, è necessario collaborare con il provider di servizi per eseguire il deprovisioning del circuito sul lato del provider.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. Le risorse continuano a essere riservate e la fatturazione continuerà a essere applicata finché il provider di servizi non avrà completato il deprovisioning del circuito e inviato una notifica a Microsoft.We continue to reserve resources and bill you until the service provider completes deprovisioning the circuit and notifies us.
  • È possibile eliminare il circuito se il provider del servizio ne ha effettuato il deprovisioning.You can delete the circuit if the service provider has deprovisioned the circuit. Dopo il deprovisioning di un circuito, lo stato di provisioning del provider di servizio è impostato su Senza provisioning.When a circuit is deprovisioned, the service provider provisioning state is set to Not provisioned. Viene così interrotta la fatturazione per il circuito.This stops billing for the circuit.

È possibile eliminare un circuito ExpressRoute eseguendo questo comando:You can delete your ExpressRoute circuit by running the following command:

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

Passaggi successiviNext steps

Dopo aver creato il circuito, verificare di eseguire le attività seguenti:After you create your circuit, make sure that you do the following tasks: