Modificare un circuito ExpressRoute mediante PowerShell (versione classica)Modify an ExpressRoute circuit using PowerShell (classic)

L'articolo illustra anche le procedure di controllo di stato, aggiornamento, eliminazione e deprovisioning di un circuito ExpressRoute.This article also shows you how to check the status, update, or delete and deprovision an ExpressRoute circuit.

Importante

A partire dall'1 marzo 2017, non è possibile creare nuovi circuiti di ExpressRoute nel modello di distribuzione classica.As of March 1, 2017, you can't create new ExpressRoute circuits in the classic deployment model.

  • È 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.You can move an existing ExpressRoute circuit from the classic deployment model to the Resource Manager deployment model without experiencing any connectivity down time. Per altre informazioni, vedere Spostare un circuito esistente.For more information, see Move an existing circuit.
  • È possibile connettersi alle reti virtuali nel modello di distribuzione classica impostando allowClassicOperations su TRUE.You can connect to virtual networks in the classic deployment model by setting allowClassicOperations to TRUE.

Usare i collegamenti seguenti per creare e gestire circuiti di ExpressRoute nel modello di distribuzione Resource Manager:Use the following links to create and manage ExpressRoute circuits in the Resource Manager deployment model:

Informazioni sui modelli di distribuzione di AzureAbout Azure deployment modelsAbout Azure deployment models

Azure attualmente funziona con due modelli di distribuzione: Azure Resource Manager e classica.Azure currently works with two deployment models: Resource Manager and classic. I due modelli non sono completamente compatibili tra loro.The two models are not completely compatible with each other. Prima di iniziare, è necessario conoscere il modello da usare.Before you begin, you need to know which model that you want to work in. Per informazioni, vedere l'articolo contenente le informazioni sui modelli di distribuzione.For information about the deployment models, see Understanding deployment models. Se non si ha familiarità con Azure, è consigliabile usare il modello di distribuzione Resource Manager.If you are new to Azure, we recommend that you use the Resource Manager deployment model.

Prima di iniziareBefore you begin

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).Install the latest versions of the Azure Service Management (SM) PowerShell modules Follow the instructions in Getting started with Azure PowerShell cmdlets for step-by-step guidance on how to configure your computer to use the Azure PowerShell modules.

Ottenere lo stato di un circuitoGet the status of a circuit

È possibile recuperare queste informazioni in qualsiasi momento usando il cmdlet Get-AzureCircuit .You can retrieve this information at any time by using the Get-AzureCircuit cmdlet. Se si effettua la chiamata senza parametri, verranno elencati tutti i circuiti.Making the call without any parameters lists all the circuits.

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.You can get information on a specific ExpressRoute circuit by passing the service key as a parameter to the call.

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:You can get detailed descriptions of all the parameters by running the following example:

get-help get-azurededicatedcircuit -detailed

Modificare un circuitoModify a 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 eseguire le attività seguenti senza tempi di inattività:You can do the following tasks with no downtime:

  • Abilitare o disabilitare un componente aggiuntivo ExpressRoute Premium per il circuito ExpressRoute.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à.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 è supportato.Downgrading the bandwidth of a circuit is not supported.
  • Modificare il piano di misurazione da Dati a consumo a Dati senza limiti.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 è supportata.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 .Refer to the ExpressRoute FAQ for more information on limits and limitations.

Abilitare il componente aggiuntivo ExpressRoute PremiumEnable the ExpressRoute premium add-on

È possibile abilitare il componente aggiuntivo ExpressRoute Premium per il circuito esistente usando il cmdlet di PowerShell seguente:You can enable the ExpressRoute premium add-on for your existing circuit by using the following PowerShell cmdlet:

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.Your circuit will now have the ExpressRoute premium add-on features enabled. La fatturazione della funzionalità del componente aggiuntivo Premium inizia non appena il comando viene eseguito correttamente.As soon as the command has been successfully run, billing for the premium add-on capability begins.

Disabilitare il componente aggiuntivo ExpressRoute PremiumDisable 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.

ConsiderazioniConsiderations

  • Assicurarsi che il numero di reti virtuali collegate al circuito sia minore di 10 prima di eseguire il downgrade da premium a standard.Make sure that the number of virtual networks linked to the circuit is less than 10 before you downgrade from premium to standard. Altrimenti, la richiesta di aggiornamento avrà esito negativo e verranno fatturate le tariffe Premium.If you don't do this, your update request fails, and you are billed the premium rates.
  • È necessario scollegare tutte le reti virtuali in altre aree geopolitiche.You must unlink all virtual networks in other geopolitical regions. Altrimenti, la richiesta di aggiornamento avrà esito negativo e verranno fatturate le tariffe Premium.If you don't, your update request fails, and you are billed the 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 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.If your route table size is greater than 4,000 routes, the BGP session drops and won't be reenabled until the number of advertised prefixes goes below 4,000.

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

È possibile disabilitare il componente aggiuntivo ExpressRoute Premium per il circuito esistente usando il cmdlet di PowerShell seguente:You can disable the ExpressRoute premium add-on for your existing circuit by using the following PowerShell cmdlet:


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 ExpressRouteUpdate the ExpressRoute circuit bandwidth

Per le opzioni relative alla larghezza di banda supportate per il provider, vedere Domande frequenti su ExpressRoute .Check the ExpressRoute FAQ for supported bandwidth options for your provider. È possibile scegliere qualsiasi dimensione maggiore della dimensione del circuito esistente, a condizione che sia consentita dalla porta fisica in cui viene creato il circuito.You can pick any size that is greater than the size of your existing circuit as long as the physical port (on which your circuit is created) allows.

Importante

Se la capacità sulla porta esistente non è sufficiente, potrebbe essere necessario ricreare il circuito ExpressRoute.You may have to recreate the ExpressRoute circuit if there is inadequate capacity on the existing port. 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.

Ridimensionare un circuitoResize a circuit

Dopo aver stabilito le dimensioni necessarie, usare il comando seguente per ridimensionare il circuito:After you decide what size you need, you can use the following command to resize your circuit:

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.Once your circuit has been sized up on the Microsoft side, you must contact your connectivity provider to update configurations on their side to match this change. La fatturazione inizierà per la larghezza di banda aggiornata da questo punto in poi.Billing begins for the updated bandwidth option from this point on.

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.If you see the following error when increasing the circuit bandwidth, it means there is no sufficient bandwidth left on the physical port where your existing circuit is created. È necessario eliminare questo circuito e crearne uno nuovo delle dimensioni necessarie.You must delete this circuit and create a new circuit of the size you need.

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 circuitoDeprovision and delete a circuit

ConsiderazioniConsiderations

  • Affinché l'operazione abbia esito positivo, è necessario scollegare tutte le reti virtuali dal circuito ExpressRoute.You must unlink all virtual networks from the ExpressRoute circuit for this operation to succeed. Se l'operazione ha esito negativo, controllare se sono presenti reti virtuali collegate al circuito.Check to see if you have any virtual networks that are linked to the circuit if this operation fails.
  • 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.
  • 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.If the service provider has deprovisioned the circuit (the service provider provisioning state is set to Not provisioned), you can then delete the circuit. Viene così interrotta la fatturazione per il circuito.This stops billing for the circuit.

Eliminare un circuitoDelete a circuit

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

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