Modificare un circuito ExpressRoute mediante PowerShell (versione classica)
Questo articolo illustra i passaggi per verificare lo stato, aggiornare o eliminare ed effettuare il deprovisioning del circuito del modello di distribuzione classica ExpressRoute. Questo articolo si applica al modello di distribuzione classica.
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
Installare le versioni più recenti dei moduli di PowerShell per Gestione dei servizi di Azure e il modulo ExpressRoute. Non è possibile usare l'ambiente Azure CloudShell per eseguire moduli di Gestione dei servizi.
Per installare il modulo di Gestione dei servizi di Azure, seguire le istruzioni riportate nell'articolo Installazione del modulo di Gestione dei servizi. Se è già installato il modulo Az o di Resource Manager, assicurarsi di usare "-AllowClobber".
Importare i moduli installati. Quando si usa l'esempio seguente, modificare il percorso in base alla posizione e alla versione dei moduli di PowerShell installati.
Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.3.0\Azure.psd1' Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.3.0\ExpressRoute\ExpressRoute.psd1'Per accedere all'account Azure, aprire la console di PowerShell con diritti elevati e connettersi all'account. Usare l'esempio seguente per connettersi tramite il modulo di Gestione dei servizi:
Add-AzureAccount
Ottenere lo stato di un circuito
È 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
Modificare un circuito
È possibile modificare determinate proprietà di un circuito ExpressRoute senza conseguenze per la connettività.
È possibile eseguire le attività 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à. Il downgrade della larghezza di banda di un circuito non è supportato.
- Modificare il piano di misurazione da Dati a consumo a Dati senza limiti. La modifica del piano di misurazione da Dati senza limiti a Dati a consumo non è supportata.
- È possibile abilitare e disabilitare l'opzione Consenti operazioni classiche.
Per altre informazioni su limiti e limitazioni, vedere Domande frequenti su ExpressRoute .
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 inizia non appena il comando viene eseguito correttamente.
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
- Assicurarsi che il numero di reti virtuali collegate al circuito sia minore di 10 prima di eseguire il downgrade da premium a standard. Altrimenti, la richiesta di aggiornamento avrà esito negativo e verranno fatturate le tariffe Premium.
- È necessario scollegare tutte le reti virtuali in altre aree geopolitiche. Altrimenti, 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 4.000 route, la sessione BGP viene eliminata e non sarà riabilitata finché il numero di prefissi pubblicati non scenderà al di sotto di 4.000.
Per 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
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
Dopo che il circuito è stato ridimensionato su lato di competenza di Microsoft, sarà necessario contattare il provider di connettività perché aggiorni le configurazioni corrispondenti in base a questa modifica. La fatturazione inizierà 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
Effettuare il deprovisioning ed eliminare un circuito
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 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.
- 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. Viene così interrotta la fatturazione per il circuito.
Eliminare un circuito
È possibile eliminare un circuito ExpressRoute eseguendo questo comando:
Remove-AzureDedicatedCircuit -ServiceKey "*********************************"