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

Este artigo orienta você pelas etapas para verificar o status, atualização ou delete e desprovisionar o circuito de modelo de implantação clássico de 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 se aplica ao modelo de implantação clássico.This article applies to the classic deployment model.

Importante

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

  • Você pode mover um circuito do ExpressRoute existente do modelo de implantação clássico para o modelo de implantação do Resource Manager sem experimentar qualquer tempo de inatividade na 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 saber mais, veja Mover um circuito existente.For more information, see Move an existing circuit.
  • Você pode se conectar às redes virtuais no modelo de implantação clássico definindo allowClassicOperations como TRUE.You can connect to virtual networks in the classic deployment model by setting allowClassicOperations to TRUE.

Use os links a seguir para criar e gerenciar circuitos do ExpressRoute no modelo de implantação do Resource Manager.Use the following links to create and manage ExpressRoute circuits in the Resource Manager deployment model:

Sobre modelos de implantação do AzureAbout Azure deployment models

Atualmente, o Azure funciona com dois modelos de implantação: Resource Manager e clássico.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, você precisa saber em qual modelo deseja trabalhar.Before you begin, you need to know which model that you want to work in. Para obter informações sobre os modelos de implantação, consulte Noções básicas sobre modelos de implantação.For information about the deployment models, see Understanding deployment models. Se você for novo no Azure, recomendamos o uso do modelo de implantação do Gerenciador de Recursos.If you are new to Azure, we recommend that you use the Resource Manager deployment model.

Observação

Este artigo foi atualizado para usar o novo módulo Az do Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Você ainda pode usar o módulo AzureRM, que continuará a receber as correções de bugs até pelo menos dezembro de 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Para saber mais sobre o novo módulo Az e a compatibilidade com o AzureRM, confira Apresentação do novo módulo Az do Azure PowerShell.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Para obter instruções de instalação do módulo Az, confira Instalar o Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Antes de começarBefore you begin

Instale as versões mais recentes dos módulos PowerShell do SM (Gerenciamento de Serviços) do Azure e do módulo ExpressRoute.Install the latest versions of the Azure Service Management (SM) PowerShell modules and the ExpressRoute module. Ao usar o exemplo a seguir, observe que o número da versão (neste exemplo, 5.1.1) será alterado conforme as versões mais recentes dos cmdlets forem lançadas.When using the following example, note that the version number (in this example, 5.1.1) will change as newer versions of the cmdlets are released.

Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.1.1\Azure\Azure.psd1'
Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.1.1\ExpressRoute\ExpressRoute.psd1'

Se você precisar de mais informações sobre o Azure PowerShell, consulte Introdução aos cmdlets do Azure PowerShell para obter orientações passo a passo sobre como configurar o computador para usar os módulos do Azure PowerShell.If you need more information about Azure PowerShell, see Getting started with Azure PowerShell cmdlets for step-by-step guidance on how to configure your computer to use the Azure PowerShell modules.

Para entrar na conta do Azure, use o seguinte exemplo:To sign in to your Azure account, use the following example:

  1. Abra o console do PowerShell com direitos elevados e conecte-se à sua conta.Open your PowerShell console with elevated rights and connect to your account. Use o exemplo a seguir para ajudar a se conectar:Use the following example to help you connect:

    Connect-AzAccount
    
  2. Verificar as assinaturas da conta.Check the subscriptions for the account.

    Get-AzSubscription
    
  3. Se você tiver mais de uma assinatura, selecione a assinatura que deseja usar.If you have more than one subscription, select the subscription that you want to use.

    Select-AzSubscription -SubscriptionName "Replace_with_your_subscription_name"
    
  4. Use o cmdlet a seguir para adicionar sua assinatura do Azure ao PowerShell para o modelo de implantação clássico.Next, use the following cmdlet to add your Azure subscription to PowerShell for the classic deployment model.

    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 listará 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 do 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 certas propriedades de um circuito do ExpressRoute sem afetar a conectividade.You can modify certain properties of an ExpressRoute circuit without impacting connectivity.

É possível executar as seguintes tarefas sem tempo de inatividade:You can do the following tasks with no downtime:

  • Como habilitar ou desabilitar o complemento premium do ExpressRoute para seu circuito do ExpressRoute.Enable or disable an ExpressRoute premium add-on for your ExpressRoute circuit.
  • Aumente a largura de banda do circuito de ExpressRoute, desde que haja capacidade disponível na porta.Increase the bandwidth of your ExpressRoute circuit provided there is capacity available on the port. Não há suporte para o downgrade da largura de banda de um circuito.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 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.

Confira as Perguntas frequentes sobre o ExpressRoute para saber mais sobre limites e limitações.Refer to the ExpressRoute FAQ for more information on limits and limitations.

Para habilitar o complemento premium do ExpressRouteEnable the ExpressRoute premium add-on

Você pode habilitar o complemento premium do ExpressRoute para o 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

O seu circuito agora tem os recursos do complemento premium do ExpressRoute habilitados.Your circuit will now have the ExpressRoute premium add-on features enabled. Assim que o comando for executado com êxito, a cobrança pela funcionalidade do 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

Esta operação poderá falhar se você estiver usando recursos que ultrapassem o que é 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 do que 10 antes de fazer o downgrade de Premium para padrão.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, sua solicitação de atualização falhará e você será cobrado conforme as tarifas premium.If you don't do this, your update request fails, and you are billed the premium rates.
  • Você precisa desvincular todas as redes virtuais em outras regiões geopolíticas.You must unlink all virtual networks in other geopolitical regions. Se você não fizer isso, sua solicitação de atualização falhará e você será cobrado conforme as tarifas premium.If you don't, your update request fails, and you are billed the premium rates.
  • Sua tabela de roteamento 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 roteamento for maior que 4.000 rotas, a sessão BGP será descartada e não poderá 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.

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

Confira as Perguntas frequentes sobre o ExpressRoute para obter opções de largura de banda com suporte para seu provedor.Check the ExpressRoute FAQ for supported bandwidth options for your provider. Você pode escolher um tamanho maior do que o tamanho do circuito existente, desde que a porta física (na qual o circuito foi 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 de ExpressRoute se não houver capacidade adequada na porta existente.You may have to recreate the ExpressRoute circuit if there is inadequate capacity on the existing port. Você não pode atualizar o circuito não se 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 um 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

Após decidir de qual tamanho 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

Uma vez que o seu circuito está escalado ao lado Microsoft, contate seu provedor de conectividade para que faça a atualização das configurações no lado dele de modo a 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. Observe que passaremos a lhe cobrar pela opção de largura de banda atualizada a partir desse momento.Billing begins for the updated bandwidth option from this point on.

Se você vir o seguinte erro quando aumentar a largura de banda do circuito, isso significa que não há largura de banda suficiente restante na porta física onde o circuito existente foi 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. Será necessário excluir este circuito e criar um novo circuito do tamanho que você precisa.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 circuto do ExpressRoute para que a operação seja bem-sucedida.You must unlink all virtual networks from the ExpressRoute circuit for this operation to succeed. Se essa operação falhar, verifique se você tem redes virtuais vinculadas ao circuito.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 de ExpressRoute for Provisionando ou Provisionado, você deverá trabalhar com seu provedor de serviços para que ele desprovisione o circuito.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. Continuaremos a reservar recursos e a cobrar de você até que o provedor de serviços complete 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), exclua 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. Isso interrompe a cobrança pelo circuito.This stops billing for the circuit.

Excluir um circuitoDelete a circuit

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

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