Redefinir emparelhamentos de circuito do ExpressRoute usando Azure PowerShell
Este artigo descreve como habilitar e desabilitar emparelhamentos de um circuito ExpressRoute usando o PowerShell. Os emparelhamentos são habilitados por padrão quando você os cria. Quando você desativa um emparelhamento, a sessão do BGP na conexão principal e secundária do circuito da ExpressRoute será encerrada. Você perderá a conectividade para esse emparelhamento com a Microsoft. Quando você ativa um emparelhamento, a sessão do BGP é redefinida na conexão principal e a conexão secundária do circuito da ExpressRoute é reestabelecida. A conectividade com a Microsoft se reconecta para esse emparelhamento. Você pode habilitar e desabilitar o Emparelhamento da Microsoft e o Emparelhamento Privado do Azure em um circuito do ExpressRoute de forma independente.
Há alguns cenários em que você pode achar útil redefinir seus emparelhamentos do ExpressRoute.
- Se você quiser testar o design de recuperação de desastres e implementação. Por exemplo, você tem dois circuitos ExpressRoute. Você pode desabilitar os emparelhamentos de um circuito e forçar o tráfego de sua rede a falhar no outro circuito.
- Habilite o BFD (Detecção de Encaminhamento Bidirecional) no Emparelhamento Privado do Azure ou no Emparelhamento da Microsoft do seu circuito do ExpressRoute. O BFD será habilitado por padrão no Emparelhamento Privado do Azure, se você tiver criado o circuito do ExpressRoute após 1º de agosto de 2018, e para o Microsoft Peering após 10 de janeiro de 2020. Se o circuito foi criado antes da data listada, você precisará redefinir o emparelhamento para habilitar o BFD.
Trabalhando com o Azure PowerShell
As etapas e os exemplos deste artigo usam os módulos AZ do Azure PowerShell. Para instalar os módulos AZ localmente no computador, confira Instalar o Azure PowerShell. Para saber mais sobre o novo módulo AZ, confira Apresentando o novo módulo AZ do Azure PowerShell. Os cmdlets do PowerShell são atualizados com frequência. Se você não estiver executando a versão mais recente, os valores especificados nas instruções poderão falhar. Para localizar as versões instaladas do PowerShell no sistema, use o cmdlet Get-Module -ListAvailable Az.
Você pode usar o Azure Cloud Shell para executar a maioria dos cmdlets do PowerShell e dos comandos da CLI, em vez de instalar o Azure PowerShell ou a CLI localmente. O Azure Cloud Shell é um shell interativo gratuito que tem ferramentas comuns do Azure pré-instaladas e configuradas para uso com a conta. Para executar qualquer código contido neste artigo no Azure Cloud Shell, abra uma sessão do Cloud Shell, use o botão Copiar em um bloco de códigos para copiar o código e colá-lo na sessão do Cloud Shell com Ctrl+Shift+V no Windows e no Linux ou Cmd+Shift+V no macOS. O texto colado não é executado automaticamente, pressione Enter para executar o código.
Há algumas maneiras de inicializar o Cloud Shell:
| Opção | Link |
|---|---|
| Clique em Experimente no canto superior direito de um bloco de código. |  |
| Abra o Cloud Shell em seu navegador. |  |
| Clique no botão Cloud Shell no menu no canto superior direito do portal do Azure. |  |
Redefinir um emparelhamento
Se você estiver executando o PowerShell localmente, abra o console do PowerShell com privilégios elevados e conecte-se à sua conta. Use o exemplo a seguir para ajudar a se conectar:
Connect-AzAccountSe você tiver várias assinaturas do Azure, verifique as assinaturas para a conta.
Get-AzSubscriptionEspecifique a assinatura que você deseja usar.
Select-AzSubscription -SubscriptionName "Replace_with_your_subscription_name"Execute os seguintes comandos para recuperar seu circuito da Rota Expressa.
$ckt = Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"Identifique o emparelhamento que você deseja desativar ou ativar. Emparelhamentos é uma matriz. No exemplo a seguir, Peerings [0] é Peering e Peerings privados do Azure [1] Microsoft Peering.
Name : ExpressRouteARMCircuit ResourceGroupName : ExpressRouteResourceGroup Location : westus Id : /subscriptions/########-####-####-####-############/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit Etag : W/"cd011bef-dc79-49eb-b4c6-81fb6ea5d178" ProvisioningState : Succeeded Sku : { "Name": "Standard_MeteredData", "Tier": "Standard", "Family": "MeteredData" } CircuitProvisioningState : Enabled ServiceProviderProvisioningState : Provisioned ServiceProviderNotes : ServiceProviderProperties : { "ServiceProviderName": "Coresite", "PeeringLocation": "Los Angeles", "BandwidthInMbps": 50 } ServiceKey : ########-####-####-####-############ Peerings : [ { "Name": "AzurePrivatePeering", "Etag": "W/\"cd011bef-dc79-49eb-b4c6-81fb6ea5d178\"", "Id": "/subscriptions/########-####-####-####-############/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit/peerings/AzurePrivatePeering", "PeeringType": "AzurePrivatePeering", "State": "Enabled", "AzureASN": 12076, "PeerASN": 123, "PrimaryPeerAddressPrefix": "10.0.0.0/30", "SecondaryPeerAddressPrefix": "10.0.0.4/30", "PrimaryAzurePort": "", "SecondaryAzurePort": "", "VlanId": 789, "MicrosoftPeeringConfig": { "AdvertisedPublicPrefixes": [], "AdvertisedCommunities": [], "AdvertisedPublicPrefixesState": "NotConfigured", "CustomerASN": 0, "LegacyMode": 0, "RoutingRegistryName": "NONE" }, "ProvisioningState": "Succeeded", "GatewayManagerEtag": "", "LastModifiedBy": "Customer", "Connections": [] }, { "Name": "MicrosoftPeering", "Etag": "W/\"cd011bef-dc79-49eb-b4c6-81fb6ea5d178\"", "Id": "/subscriptions/########-####-####-####-############/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit/peerings/MicrosoftPeering", "PeeringType": "MicrosoftPeering", "State": "Enabled", "AzureASN": 12076, "PeerASN": 123, "PrimaryPeerAddressPrefix": "3.0.0.0/30", "SecondaryPeerAddressPrefix": "3.0.0.4/30", "PrimaryAzurePort": "", "SecondaryAzurePort": "", "VlanId": 345, "MicrosoftPeeringConfig": { "AdvertisedPublicPrefixes": [ "3.0.0.3/32" ], "AdvertisedCommunities": [], "AdvertisedPublicPrefixesState": "ValidationNeeded", "CustomerASN": 0, "LegacyMode": 0, "RoutingRegistryName": "NONE" }, "ProvisioningState": "Succeeded", "GatewayManagerEtag": "", "LastModifiedBy": "Customer", "Connections": [] } ] Authorizations : [] AllowClassicOperations : False GatewayManagerEtag :Execute os seguintes comandos para alterar o estado do emparelhamento para desabilitado.
$ckt.Peerings[0].State = "Disabled" Set-AzExpressRouteCircuit -ExpressRouteCircuit $cktO emparelhamento deve estar em um estado desabilitado que você definiu.
Execute os seguintes comandos para alterar o estado do emparelhamento para habilitado.
$ckt.Peerings[0].State = "Enabled" Set-AzExpressRouteCircuit -ExpressRouteCircuit $cktO emparelhamento deve estar em um estado habilitado que você definiu.
Próximas etapas
Se você precisar de ajuda para solucionar um problema do ExpressRoute, veja os artigos a seguir: