Modificar um circuito do ExpressRoute com o PowerShell (clássico)Modify an ExpressRoute circuit using PowerShell (classic)

Este artigo orienta você pelas etapas para verificar o status, atualizar ou excluir e desprovisionar seu circuito de modelo de implantação clássico do ExpressRoute.This article walks you through the steps to check the status, update, or delete and deprovision your ExpressRoute classic deployment model circuit. Este artigo aplica-se ao modelo de implementação clássica.This article applies to the classic deployment model.

Importante

A partir de 1 de março de 2017, não é possível criar os novos circuitos do ExpressRoute no modelo de implementação clássico.As of March 1, 2017, you can't create new ExpressRoute circuits in the classic deployment model.

  • Pode mover um circuito do ExpressRoute existente a partir do modelo de implementação clássica para o modelo de implementação do Gestor de Recursos, sem experienciar qualquer período de inatividade de conectividade.You can move an existing ExpressRoute circuit from the classic deployment model to the Resource Manager deployment model without experiencing any connectivity down time. Para obter mais informações, consulte Move an existing circuit (Mover um circuito existente).For more information, see Move an existing circuit.
  • Pode ligar a redes virtuais no modelo de implementação clássica ao definir allowClassicOperations como TRUE.You can connect to virtual networks in the classic deployment model by setting allowClassicOperations to TRUE.

Utilize as seguintes ligações para criar e gerir circuitos do ExpressRoute no modelo de implementação do Gestor de Recursos:Use the following links to create and manage ExpressRoute circuits in the Resource Manager deployment model:

Acerca dos modelos de implementação do AzureAbout Azure deployment models

O Azure funciona atualmente com dois modelos de implementação: Resource Manager e clássica.Azure currently works with two deployment models: Resource Manager and classic. Os dois modelos não são totalmente compatíveis entre si.The two models are not completely compatible with each other. Antes de começar, deve saber em que modelo pretende trabalhar.Before you begin, you need to know which model that you want to work in. Para obter informações sobre os modelos de implementação, veja Compreender os modelos de implementação.For information about the deployment models, see Understanding deployment models. Se estiver familiarizado com o Azure, recomendamos que utilize o modelo de implementação do Resource Manager.If you are new to Azure, we recommend that you use the Resource Manager deployment model.

Antes de começarBefore you begin

Instale as versões mais recentes dos módulos do PowerShell do gerenciamento de serviços do Azure (SM) e do módulo ExpressRoute.Install the latest versions of the Azure Service Management (SM) PowerShell modules and the ExpressRoute module. Você não pode usar o ambiente CloudShell do Azure para executar módulos SM.You can't use the Azure CloudShell environment to run SM modules.

  1. Use as instruções no artigo instalando o módulo de gerenciamento de serviços para instalar o módulo de gerenciamento de serviços do Azure.Use the instructions in the Installing the Service Management module article to install the Azure Service Management Module. Se você tiver o módulo AZ ou RM já instalado, certifique-se de usar '-AllowClobber '.If you have the Az or RM module already installed, be sure to use '-AllowClobber'.

  2. Importe os módulos instalados.Import the installed modules. Ao usar o exemplo a seguir, ajuste o caminho para refletir o local dos seus módulos do PowerShell instalados.When using the following example, adjust the path to reflect the location of your installed PowerShell modules.

    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'
    
  3. Para entrar em sua conta do Azure, abra o console do PowerShell com direitos elevados e conecte-se à sua conta.To sign in to your Azure account, open your PowerShell console with elevated rights and connect to your account. Use o exemplo a seguir para ajudá-lo a se conectar usando o módulo de gerenciamento de serviços:Use the following example to help you connect using the Service Management module:

    Add-AzureAccount
    

Obter o status de um circuitoGet the status of a circuit

Você pode recuperar essas informações a qualquer momento usando o cmdlet Get-AzureCircuit.You can retrieve this information at any time by using the Get-AzureCircuit cmdlet. Fazer a chamada sem parâmetros lista todos os circuitos.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

Você pode obter informações sobre um circuito do ExpressRoute específico passando a chave de serviço como um parâmetro para a chamada.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

Você pode obter descrições detalhadas de todos os parâmetros executando o seguinte exemplo:You can get detailed descriptions of all the parameters by running the following example:

get-help get-azurededicatedcircuit -detailed

Modificar um circuitoModify a circuit

Você pode modificar determinadas propriedades de um circuito do ExpressRoute sem afetar a conectividade.You can modify certain properties of an ExpressRoute circuit without impacting connectivity.

Você pode executar as seguintes tarefas sem tempo de inatividade:You can do the following tasks with no downtime:

  • Habilite ou desabilite um complemento Premium do ExpressRoute para o circuito do ExpressRoute.Enable or disable an ExpressRoute premium add-on for your ExpressRoute circuit.
  • Aumente a largura de banda do circuito do ExpressRoute, desde que haja capacidade disponível na porta.Increase the bandwidth of your ExpressRoute circuit provided there is capacity available on the port. Desatualização de largura de banda de um circuito não é suportada.Downgrading the bandwidth of a circuit is not supported.
  • Altere o plano de medição de dados limitados para dados ilimitados.Change the metering plan from Metered Data to Unlimited Data. Não há suporte para a alteração do plano de medição de dados ilimitados para dados limitados.Changing the metering plan from Unlimited Data to Metered Data is not supported.
  • Você pode habilitar e desabilitar permitir operações clássicas.You can enable and disable Allow Classic Operations.

Consulte as perguntas frequentes sobre o ExpressRoute para obter mais informações sobre limites e limitações.Refer to the ExpressRoute FAQ for more information on limits and limitations.

Habilitar o complemento Premium do ExpressRouteEnable the ExpressRoute premium add-on

Você pode habilitar o complemento Premium do ExpressRoute para seu circuito existente usando o seguinte cmdlet do PowerShell: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

Seu circuito agora terá os recursos complementares do ExpressRoute Premium habilitados.Your circuit will now have the ExpressRoute premium add-on features enabled. Assim que o comando for executado com êxito, a cobrança do recurso de complemento Premium começará.As soon as the command has been successfully run, billing for the premium add-on capability begins.

Desabilitar o complemento Premium do ExpressRouteDisable the ExpressRoute premium add-on

Importante

Essa operação poderá falhar se você estiver usando recursos que são maiores do que o permitido para o circuito padrão.This operation can fail if you're using resources that are greater than what is permitted for the standard circuit.

ConsideraçõesConsiderations

  • Verifique se o número de redes virtuais vinculadas ao circuito é menor que 10 antes de fazer o downgrade de Premium para Standard.Make sure that the number of virtual networks linked to the circuit is less than 10 before you downgrade from premium to standard. Se você não fizer isso, a solicitação de atualização falhará e você será cobrado pelas tarifas Premium.If you don't do this, your update request fails, and you are billed the premium rates.
  • Você deve desvincular todas as redes virtuais em outras regiões do geopolítica.You must unlink all virtual networks in other geopolitical regions. Se você não fizer isso, a solicitação de atualização falhará e você será cobrado pelas tarifas Premium.If you don't, your update request fails, and you are billed the premium rates.
  • Sua tabela de rotas deve ter menos de 4.000 rotas para o emparelhamento privado.Your route table must be less than 4,000 routes for private peering. Se o tamanho da tabela de rotas for maior que 4.000 rotas, a sessão BGP cai e não será reabilitada até que o número de prefixos anunciados fique abaixo de 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.

Para desabilitar o complemento PremiumTo disable the premium add-on

Você pode desabilitar o complemento Premium do ExpressRoute para o circuito existente usando o seguinte cmdlet do PowerShell: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

Atualizar a largura de banda do circuito do ExpressRouteUpdate the ExpressRoute circuit bandwidth

Verifique as perguntas frequentes do ExpressRoute para obter as opções de largura de banda com suporte para seu provedorCheck the ExpressRoute FAQ for supported bandwidth options for your provider. Você pode escolher qualquer tamanho maior que o tamanho do seu circuito existente, desde que a porta física (na qual o circuito é criado) permita.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

Talvez seja necessário recriar o circuito do ExpressRoute se houver capacidade inadequada na porta existente.You may have to recreate the ExpressRoute circuit if there is inadequate capacity on the existing port. Você não poderá atualizar o circuito se não houver capacidade adicional disponível nesse local.You cannot upgrade the circuit if there is no additional capacity available at that location.

Não é possível reduzir a largura de banda de um circuito do ExpressRoute sem interrupções.You cannot reduce the bandwidth of an ExpressRoute circuit without disruption. O downgrade da largura de banda exige o desprovisionamento do circuito do ExpressRoute e o reprovisionamento de um novo circuito do ExpressRoute.Downgrading bandwidth requires you to deprovision the ExpressRoute circuit and then reprovision a new ExpressRoute circuit.

Redimensionar um circuitoResize a circuit

Depois de decidir de qual tamanho você precisa, você pode usar o seguinte comando para redimensionar o 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

Depois que o circuito for dimensionado no lado da Microsoft, você deverá entrar em contato com seu provedor de conectividade para atualizar as configurações em seu lado para corresponder a essa alteração.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. A cobrança começa pela opção de largura de banda atualizada deste ponto em diante.Billing begins for the updated bandwidth option from this point on.

Se você vir o erro a seguir ao aumentar a largura de banda do circuito, isso significa que não há largura de banda suficiente restante na porta física em que o circuito existente é criado.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. Você deve excluir esse circuito e criar um novo circuito do tamanho necessário.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

Desprovisionar e excluir um circuitoDeprovision and delete a circuit

ConsideraçõesConsiderations

  • Você deve desvincular todas as redes virtuais do circuito do ExpressRoute para que essa operação tenha sucesso.You must unlink all virtual networks from the ExpressRoute circuit for this operation to succeed. Verifique se você tem redes virtuais vinculadas ao circuito se essa operação falhar.Check to see if you have any virtual networks that are linked to the circuit if this operation fails.
  • Se o estado de provisionamento do provedor de serviço de circuito do ExpressRoute for Provisionando ou provisionado , você deverá trabalhar com seu provedor de serviços para desprovisionar o circuito no lado deles.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. Continuamos reservando recursos e cobramos até que o provedor de serviços conclua o desprovisionamento do circuito e nos notifique.We continue to reserve resources and bill you until the service provider completes deprovisioning the circuit and notifies us.
  • Se o provedor de serviços tiver desprovisionado o circuito (o estado de provisionamento do provedor de serviços estiver definido como não provisionado), você poderá excluir o 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. Isto interrompe a faturação do circuito.This stops billing for the circuit.

Excluir um circuitoDelete a circuit

Você pode excluir o circuito do ExpressRoute executando o seguinte comando:You can delete your ExpressRoute circuit by running the following command:

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