Modificar um circuito da ExpressRoute usando o PowerShell (clássico)
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. Este artigo se aplica ao modelo de implantação clássico.
Importante
Desde 1º de março de 2017, não é possível criar novos circuitos do ExpressRoute no modelo de implantação clássico.
- 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. Para saber mais, veja Mover um circuito existente.
- Você pode se conectar às redes virtuais no modelo de implantação clássico definindo allowClassicOperations como TRUE.
Use os links a seguir para criar e gerenciar circuitos do ExpressRoute no modelo de implantação do Resource Manager.
Sobre modelos de implantação do Azure
O Azure funciona atualmente com dois modelos de implantação: o Gerenciador de recursos e o clássico. Os dois modelos não são totalmente compatíveis entre si. Antes de começar, você precisa saber em qual modelo deseja trabalhar. Para obter informações sobre os modelos de implantação, consulte Noções básicas sobre modelos de implantação. Se você for novo no Azure, recomendamos o uso do modelo de implantação do Gerenciador de Recursos.
Antes de começar
Instale as versões mais recentes dos módulos PowerShell do SM (Gerenciamento de Serviços) do Azure e do módulo ExpressRoute. Você não pode usar o ambiente do Azure Cloud Shell para executar módulos SM.
Use as instruções contidas no artigo Instalação do módulo de gerenciamento de serviços para instalar o Módulo de Gerenciamento de Serviços do Azure. Se você tiver o módulo AZ ou RM já instalado, não se esqueça de usar '-AllowClobber'.
Importe os módulos instalados. Ao usar o exemplo a seguir, ajuste o caminho para refletir a localização e a versão dos módulos do PowerShell instalados.
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'Para entrar na conta do Azure, abra o console do PowerShell com privilégios elevados e conecte-se à conta. Use o seguinte exemplo para obter ajuda ao se conectar usando o módulo de gerenciamento de serviços:
Add-AzureAccount
Obter o status de um circuito
Você pode recuperar essas informações a qualquer momento usando o cmdlet Get-AzureCircuit . Fazer a chamada sem parâmetros listará todos os circuitos.
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.
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:
get-help get-azurededicatedcircuit -detailed
Modificar um circuito
Você pode modificar certas propriedades de um circuito do ExpressRoute sem afetar a conectividade.
É possível executar as seguintes tarefas sem tempo de inatividade:
- Como habilitar ou desabilitar o complemento premium do ExpressRoute para seu circuito do ExpressRoute.
- Aumente a largura de banda do circuito de ExpressRoute, desde que haja capacidade disponível na porta. Não há suporte para o downgrade da largura de banda de um circuito.
- Altere o plano de medição de Dados Limitados para Dados Ilimitados. Não há suporte para alteração do plano de medição de Dados Ilimitados para Dados Limitados.
- Você pode habilitar e desabilitar Permitir Operações Clássicas.
Confira as Perguntas frequentes sobre o ExpressRoute para saber mais sobre limites e limitações.
Para habilitar o complemento premium do ExpressRoute
Você pode habilitar o complemento premium do ExpressRoute para o circuito existente usando o seguinte cmdlet do PowerShell:
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. Assim que o comando for executado com êxito, a cobrança pela funcionalidade do complemento Premium começará.
Desabilitar o complemento premium do ExpressRoute
Importante
Esta operação poderá falhar se você estiver usando recursos que ultrapassem o que é permitido para o circuito padrão.
Considerações
- 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. Se você não fizer isso, sua solicitação de atualização falhará e você será cobrado conforme as tarifas premium.
- Você precisa desvincular todas as redes virtuais em outras regiões geopolíticas. Se você não fizer isso, sua solicitação de atualização falhará e você será cobrado conforme as tarifas premium.
- Sua tabela de roteamento deve ter menos de 4.000 rotas para o emparelhamento privado. 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.
Desabilitar o complemento premium
Você pode desabilitar o complemento premium do ExpressRoute para o circuito existente usando o seguinte cmdlet do PowerShell:
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 ExpressRoute
Confira as Perguntas frequentes sobre o ExpressRoute para obter opções de largura de banda com suporte para seu provedor. 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.
Importante
Talvez seja necessário recriar o circuito de ExpressRoute se não houver capacidade adequada na porta existente. Você não pode atualizar o circuito não se houver capacidade adicional disponível nesse local.
Não é possível reduzir a largura de banda de um circuito do ExpressRoute sem interrupções. O downgrade da largura de banda exige o desprovisionamento do circuito do ExpressRoute e um reprovisionamento de um novo circuito do ExpressRoute.
Redimensionar um circuito
Após decidir de qual tamanho precisa, você pode usar o seguinte comando para redimensionar o circuito:
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. Observe que passaremos a lhe cobrar pela opção de largura de banda atualizada a partir desse momento.
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. Será necessário excluir este circuito e criar um novo circuito do tamanho que você precisa.
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 circuito
Considerações
- Você deve desvincular todas as redes virtuais do circuto do ExpressRoute para que a operação seja bem-sucedida. Se essa operação falhar, verifique se você tem redes virtuais vinculadas ao circuito.
- 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. Continuaremos a reservar recursos e a cobrar de você até que o provedor de serviços complete o desprovisionamento do circuito e nos notifique.
- 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. Isso interrompe a cobrança pelo circuito.
Excluir um circuito
Você pode excluir o circuito do ExpressRoute executando o comando a seguir:
Remove-AzureDedicatedCircuit -ServiceKey "*********************************"