Redefinir emparelhamentos de circuito de Rota Expressa usando o Azure PowerShell
Este artigo descreve como habilitar e desabilitar emparelhamentos de um circuito de Rota Expressa usando o PowerShell. Os emparelhamentos são habilitados por padrão quando você os cria. Quando você desabilita um emparelhamento, a sessão BGP na conexão primária e secundária do circuito da Rota Expressa é desconectada. Você perde a conectividade desse emparelhamento com a Microsoft. Quando você habilita um emparelhamento, a sessão BGP na conexão primária e secundária do circuito da Rota Expressa é estabelecida. A conectividade com a Microsoft se reconecta para esse emparelhamento. Você pode habilitar e desabilitar o emparelhamento para o Microsoft Peering e o Azure Private Peering independentemente no circuito ExpressRoute.
Há dois cenários em que você pode achar útil redefinir seus pares de Rota Expressa.
- Se você quiser testar seu projeto e implementação de recuperação de desastres. Por exemplo, você tem dois circuitos ExpressRoute. Você pode desativar os emparelhamentos em um circuito e forçar o tráfego de rede a fazer failover para o outro circuito.
- Habilite a Deteção de Encaminhamento Bidirecional (BFD) no Emparelhamento Privado do Azure ou no Emparelhamento da Microsoft do seu circuito de Rota Expressa. O BFD é habilitado por padrão no Emparelhamento Privado do Azure se você criou seu circuito de Rota Expressa após 1º de agosto de 2018 e para o Microsoft Peering após 10 de janeiro de 2020. Se o seu circuito foi criado antes da data listada, você precisa redefinir o emparelhamento para ativar o BFD.
Trabalhando com o Azure PowerShell
As etapas e exemplos neste artigo usam módulos Az do Azure PowerShell. Para instalar os módulos Az localmente no seu computador, consulte Instalar o Azure PowerShell. Para saber mais sobre o novo módulo Az, consulte 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 podem falhar. Para localizar as versões instaladas do PowerShell em seu sistema, use o Get-Module -ListAvailable Az cmdlet.
Você pode usar o Azure Cloud Shell para executar a maioria dos cmdlets do PowerShell e 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 está configurado para ser usado com sua 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ódigo para copiar o código e cole-o na sessão do Cloud Shell com Ctrl+Shift+V no Windows e Linux ou Cmd+Shift+V no macOS. O texto colado não é executado automaticamente, pressione Enter para executar o código.
Existem algumas formas de iniciar o Cloud Shell:
| Opção | Associar |
|---|---|
| Clique em Experimentar no canto superior direito de um bloco de código. |  |
| Abrir o Cloud Shell no seu browser. |  |
| Clique no botão Cloud Shell, no menu do canto superior direito do portal do Azure. |  |
Redefinir um emparelhamento
Se você estiver executando o PowerShell localmente, abra seu console do PowerShell com privilégios elevados e conecte-se à sua conta. Utilize o exemplo seguinte para o ajudar na ligação:
Connect-AzAccountSe tiver múltiplas subscrições do Azure, verifique as subscrições da conta.
Get-AzSubscriptionEspecifique a subscrição que pretende utilizar.
Select-AzSubscription -SubscriptionName "Replace_with_your_subscription_name"Execute os seguintes comandos para recuperar seu circuito de Rota Expressa.
$ckt = Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"Identifique o emparelhamento que você deseja desabilitar ou habilitar. Peerings é uma matriz. No exemplo a seguir, Peerings[0] é o Azure Private Peering and Peerings[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 de emparelhamento para desativado.
$ckt.Peerings[0].State = "Disabled" Set-AzExpressRouteCircuit -ExpressRouteCircuit $cktO emparelhamento deve estar em um estado desativado que você definiu.
Execute os comandos a seguir para alterar o estado de emparelhamento de volta para habilitado.
$ckt.Peerings[0].State = "Enabled" Set-AzExpressRouteCircuit -ExpressRouteCircuit $cktO emparelhamento deve estar em um estado habilitado que você definiu.
Próximos passos
Se precisar de ajuda para solucionar um problema da Rota Expressa, consulte os seguintes artigos: