Creare e modificare un circuito ExpressRoute mediante PowerShell (versione classica)

Questo articolo illustra i passaggi per creare un circuito di Azure ExpressRoute tramite i cmdlet di PowerShell e il modello di distribuzione classica. L'articolo illustra anche le procedure di controllo di stato, aggiornamento, eliminazione e deprovisioning di un circuito ExpressRoute.

Importante

A partire dall'1 marzo 2017, non è possibile creare nuovi circuiti di ExpressRoute nel modello di distribuzione classica.

  • È possibile spostare un circuito di ExpressRoute esistente dal modello di distribuzione classica al modello di distribuzione Resource Manager senza eventuali tempi di inattività della connessione. Per altre informazioni, vedere Spostare un circuito esistente.
  • È possibile connettersi alle reti virtuali nel modello di distribuzione classica impostando allowClassicOperations su TRUE.

Usare i collegamenti seguenti per creare e gestire circuiti di ExpressRoute nel modello di distribuzione Resource Manager:

Informazioni sui modelli di distribuzione di AzureAbout Azure deployment models

Azure attualmente funziona con due modelli di distribuzione: Azure Resource Manager e classica. I due modelli non sono completamente compatibili tra loro. Prima di iniziare, è necessario conoscere il modello da usare. Per informazioni, vedere l'articolo contenente le informazioni sui modelli di distribuzione. Se non si ha familiarità con Azure, è consigliabile usare il modello di distribuzione Resource Manager.

Prima di iniziare

Passaggio 1. Consultare gli articoli sui prerequisiti e sul flusso di lavoro

Prima di procedere con la configurazione, assicurarsi di avere verificato i prerequisiti e i flussi di lavoro.

Passaggio 2. Installare le versioni più recenti dei moduli di PowerShell per Gestione dei servizi di Azure.

Per istruzioni dettagliate sulla configurazione del computer per l'uso con i moduli di Azure PowerShell, vedere Getting started with Azure PowerShell cmdlets (Introduzione ai cmdlet di Azure PowerShell).

Passaggio 3. Accedere all'account Azure e selezionare una sottoscrizione

  1. Aprire la console di PowerShell con diritti elevati e connettersi all'account. Per eseguire la connessione, usare gli esempi che seguono:

     Login-AzureRmAccount
    
  2. Controllare le sottoscrizioni per l'account.

     Get-AzureRmSubscription
    
  3. Se sono disponibili più sottoscrizioni, selezionare la sottoscrizione da usare.

     Select-AzureRmSubscription -SubscriptionName "Replace_with_your_subscription_name"
    
  4. Successivamente, utilizzare il cmdlet seguente per aggiungere la sottoscrizione di Azure a PowerShell per il modello di distribuzione classico.

     Add-AzureAccount
    

Creare un circuito ExpressRoute ed eseguirne il provisioning

Passaggio 1. Importare i moduli di PowerShell per ExpressRoute

Se ancora non è stato fatto, per iniziare a usare i cmdlet per ExpressRoute, è necessario importare i moduli di Azure ed ExpressRoute nella sessione di PowerShell. Importare i moduli dal percorso in cui sono stati installati sul computer locale. A seconda del metodo usato per installare i moduli, il percorso potrebbe essere diverso da quello illustrato nell'esempio seguente. Se necessario, modificare l'esempio.

Import-Module 'C:\Program Files (x86)\Microsoft SDKs\Azure\PowerShell\ServiceManagement\Azure\Azure.psd1'
Import-Module 'C:\Program Files (x86)\Microsoft SDKs\Azure\PowerShell\ServiceManagement\Azure\ExpressRoute\ExpressRoute.psd1'

Passaggio 2. Ottenere l'elenco dei provider, delle località e delle larghezze di banda supportate

Prima di creare un circuito ExpressRoute, è necessario avere l'elenco delle località, delle opzioni di larghezza di banda e dei provider di connettività supportati.

Il cmdlet Get-AzureDedicatedCircuitServiceProvider di PowerShell restituisce queste informazioni, che verranno usate nei passaggi successivi:

Get-AzureDedicatedCircuitServiceProvider

Verificare se sia presente anche il proprio provider di connettività. Prendere nota delle informazioni seguenti, perché saranno necessarie al momento della creazione di un circuito:

  • Nome
  • PeeringLocations
  • BandwidthsOffered

È ora possibile creare un circuito ExpressRoute.

Passaggio 3. Creare un circuito ExpressRoute

L'esempio seguente illustra come creare un circuito ExpressRoute a 200 Mbps tramite Equinix nella Silicon Valley. Se si usa un altro provider e impostazioni diverse, sostituire tali informazioni al momento della richiesta.

Importante

Il circuito ExpressRoute viene addebitato dal momento in cui emessa una chiave di servizio. Verificare che l'operazione venga eseguita quando il provider di connettività è pronto a effettuare il provisioning del circuito.

Di seguito è riportato un esempio di richiesta di una nuova chiave di servizio:

$Bandwidth = 200
$CircuitName = "MyTestCircuit"
$ServiceProvider = "Equinix"
$Location = "Silicon Valley"

New-AzureDedicatedCircuit -CircuitName $CircuitName -ServiceProviderName $ServiceProvider -Bandwidth $Bandwidth -Location $Location -sku Standard -BillingType MeteredData

Se invece si vuole creare un circuito ExpressRoute con il componente aggiuntivo Premium, usare l'esempio seguente. Per altri dettagli sul componente aggiuntivo Premium, vedere Domande frequenti su ExpressRoute .

New-AzureDedicatedCircuit -CircuitName $CircuitName -ServiceProviderName $ServiceProvider -Bandwidth $Bandwidth -Location $Location -sku Premium - BillingType MeteredData

La risposta conterrà la chiave di servizio. È possibile ottenere descrizioni dettagliate di tutti i parametri eseguendo questo comando:

get-help new-azurededicatedcircuit -detailed

Passaggio 4. Elencare tutti i circuiti ExpressRoute

Per ottenere un elenco di tutti i circuiti ExpressRoute creati, eseguire il comando Get-AzureDedicatedCircuit:

Get-AzureDedicatedCircuit

La risposta sarà simile all'esempio seguente:

Bandwidth                        : 200
CircuitName                      : MyTestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : NotProvisioned
Sku                              : Standard
Status                           : Enabled

È possibile recuperare queste informazioni in qualsiasi momento usando il cmdlet Get-AzureDedicatedCircuit . Se si effettua la chiamata senza parametri, verranno elencati tutti i circuiti. La chiave di servizio verrà elencata nel campo ServiceKey .

Get-AzureDedicatedCircuit

Bandwidth                        : 200
CircuitName                      : MyTestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : NotProvisioned
Sku                              : Standard
Status                           : Enabled

È possibile ottenere descrizioni dettagliate di tutti i parametri eseguendo questo comando:

get-help get-azurededicatedcircuit -detailed

Passaggio 5. Inviare la chiave di servizio al provider di connettività per il provisioning

ServiceProviderProvisioningState offre informazioni sullo stato di provisioning corrente sul lato provider del servizio. Status indica lo stato sul lato Microsoft. Per altre informazioni sullo stato di provisioning dei circuiti, vedere l'articolo relativo ai flussi di lavoro .

Quando si crea un nuovo circuito ExpressRoute, il circuito ha lo stato seguente:

ServiceProviderProvisioningState : NotProvisioned
Status                           : Enabled

Il circuito passa allo stato seguente quando è in corso l'abilitazione da parte del provider di connettività:

ServiceProviderProvisioningState : Provisioning
Status                           : Enabled

Un circuito ExpressRoute può essere usato solo se è impostato sullo stato seguente:

ServiceProviderProvisioningState : Provisioned
Status                           : Enabled

Passaggio 6. Controllare periodicamente lo stato e la condizione della chiave del circuito

In questo modo è possibile sapere quando il provider ha abilitato il circuito. Dopo la configurazione del circuito, ServiceProviderProvisioningState verrà visualizzato come Provisioning eseguito, come illustrato nell'esempio seguente:

Get-AzureDedicatedCircuit

Bandwidth                        : 200
CircuitName                      : MyTestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

Passaggio 7. Creare la configurazione di routing

Per istruzioni dettagliate, vedere l'articolo relativo alla configurazione del routing per un circuito ExpressRoute (creazione e modifica del peering del circuito) .

Importante

Queste istruzioni si applicano solo ai circuiti creati con provider di servizi che offrono servizi di connettività di livello 2. Se si usa un provider di servizi che offre servizi gestiti di livello 3 (di solito un IP VPN, come MPLS), il provider di connettività configurerà e gestirà il routing per conto dell'utente.

Collegare quindi una rete virtuale al circuito ExpressRoute. Per istruzioni dettagliate, vedere Collegare una rete virtuale a un circuito ExpressRoute . Se è necessario creare una rete virtuale usando il modello di distribuzione classica per ExpressRoute, vedere l'articolo relativo alla Creazione di una rete virtuale per ExpressRoute.

Ottenere lo stato di un circuito ExpressRoute

È possibile recuperare queste informazioni in qualsiasi momento usando il cmdlet Get-AzureCircuit . Se si effettua la chiamata senza parametri, verranno elencati tutti i circuiti.

Get-AzureDedicatedCircuit

Bandwidth                        : 200
CircuitName                      : MyTestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

Bandwidth                        : 1000
CircuitName                      : MyAsiaCircuit
Location                         : Singapore
ServiceKey                       : #################################
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

È possibile ottenere informazioni su un circuito ExpressRoute specifico passando la chiave di servizio come parametro alla chiamata.

Get-AzureDedicatedCircuit -ServiceKey "*********************************"

Bandwidth                        : 200
CircuitName                      : MyTestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

È possibile ottenere descrizioni dettagliate di tutti i parametri eseguendo, ad esempio, questo comando:

get-help get-azurededicatedcircuit -detailed

Modifica di un circuito ExpressRoute

È possibile modificare determinate proprietà di un circuito ExpressRoute senza conseguenze per la connettività.

È possibile eseguire le operazioni seguenti senza tempi di inattività:

  • Abilitare o disabilitare un componente aggiuntivo ExpressRoute Premium per il circuito ExpressRoute.
  • Aumentare la larghezza di banda del circuito ExpressRoute, a condizione che sulla porta sia disponibile capacità. Si noti che il downgrade della larghezza di banda di un circuito non è supportato.
  • Modificare il piano di misurazione da Dati a consumo a Dati senza limiti. Si noti che la modifica del piano di misurazione da Dati senza limiti a Dati a consumo non è supportata.
  • È possibile abilitare e disabilitare l'opzione Allow Classic Operations(Consenti operazioni classiche).

Per altre informazioni su limiti e limitazioni, vedere Domande frequenti su ExpressRoute .

Per abilitare il componente aggiuntivo ExpressRoute Premium

È possibile abilitare il componente aggiuntivo ExpressRoute Premium per il circuito esistente usando il cmdlet di PowerShell seguente:

Set-AzureDedicatedCircuitProperties -ServiceKey "*********************************" -Sku Premium

Bandwidth                        : 1000
CircuitName                      : TestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Premium
Status                           : Enabled

Il circuito avrà le funzionalità del componente aggiuntivo ExpressRoute Premium abilitate. La fatturazione della funzionalità del componente aggiuntivo Premium inizierà non appena il comando verrà eseguito correttamente.

Per disabilitare il componente aggiuntivo ExpressRoute Premium

Importante

Questa operazione può avere esito negativo se si usano più risorse di quelle consentite per il circuito standard.

Considerazioni

  • È necessario assicurarsi che il numero di reti virtuali collegate al circuito sia minore di 10 prima di eseguire il downgrade da premium a standard. In caso contrario, la richiesta di aggiornamento avrà esito negativo e verranno fatturate le tariffe Premium.
  • È necessario scollegare tutte le reti virtuali in altre aree geopolitiche. In caso contrario, la richiesta di aggiornamento avrà esito negativo e verranno fatturate le tariffe Premium.
  • La tabella di route deve includere meno di 4.000 route per il peering privato. Se la tabella di route include più di 4000 route, la sessione BGP verrà eliminata e non sarà riabilitata finché il numero di prefissi pubblicati non scenderà al di sotto di 4000.

Disabilitare il componente aggiuntivo Premium

È possibile disabilitare il componente aggiuntivo ExpressRoute Premium per il circuito esistente usando il cmdlet di PowerShell seguente:

Set-AzureDedicatedCircuitProperties -ServiceKey "*********************************" -Sku Standard

Bandwidth                        : 1000
CircuitName                      : TestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

Per aggiornare la larghezza di banda del circuito ExpressRoute

Per le opzioni relative alla larghezza di banda supportate per il provider, vedere Domande frequenti su ExpressRoute . È possibile scegliere qualsiasi dimensione maggiore della dimensione del circuito esistente, a condizione che sia consentita dalla porta fisica in cui viene creato il circuito.

Importante

Se la capacità sulla porta esistente non è sufficiente, potrebbe essere necessario ricreare il circuito ExpressRoute. Il circuito non può essere aggiornato se in tale posizione non è disponibile capacità aggiuntiva.

Non è possibile ridurre la larghezza di banda di un circuito ExpressRoute senza interruzioni. Il downgrade della larghezza di banda richiede il deprovisioning del circuito ExpressRoute e quindi il provisioning di un nuovo circuito ExpressRoute.

Ridimensionare un circuito

Dopo aver stabilito le dimensioni necessarie, usare il comando seguente per ridimensionare il circuito:

Set-AzureDedicatedCircuitProperties -ServiceKey ********************************* -Bandwidth 1000

Bandwidth                        : 1000
CircuitName                      : TestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

Il circuito verrà ridimensionato sul lato di Microsoft. È necessario contattare il provider di connettività per aggiornare le configurazioni corrispondenti in base a questa modifica. Si noti che inizierà la fatturazione per la larghezza di banda aggiornata da questo punto in poi.

Se quando si aumenta la larghezza di banda del circuito viene visualizzato l'errore seguente, significa che la larghezza di banda rimasta nella porta fisica in cui è stato creato il circuito esistente non è sufficiente. È necessario eliminare questo circuito e crearne uno nuovo delle dimensioni necessarie.

Set-AzureDedicatedCircuitProperties : InvalidOperation : Insufficient bandwidth available to perform this circuit
update operation
At line:1 char:1
+ Set-AzureDedicatedCircuitProperties -ServiceKey ********************* ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : CloseError: (:) [Set-AzureDedicatedCircuitProperties], CloudException
    + FullyQualifiedErrorId : Microsoft.WindowsAzure.Commands.ExpressRoute.SetAzureDedicatedCircuitPropertiesCommand

Deprovisioning ed eliminazione di un circuito ExpressRoute

Considerazioni

  • Affinché l'operazione abbia esito positivo, è necessario scollegare tutte le reti virtuali dal circuito ExpressRoute. Se l'operazione ha esito negativo, controllare se sono presenti reti virtuali collegate al circuito.
  • 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. Le risorse continueranno 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.
  • Se il provider di servizi ha eseguito il deprovisioning del circuito, ovvero lo stato di provisioning del provider di servizi è impostato su Senza provisioning, è possibile eliminare il circuito. Non verrà più applicata la fatturazione corrispondente.

Eliminare un circuito

È possibile eliminare un circuito ExpressRoute eseguendo questo comando:

Remove-AzureDedicatedCircuit -ServiceKey "*********************************"

Passaggi successivi

Dopo aver creato il circuito, verificare di eseguire le operazioni seguenti: