Converter um emparelhamento herdado do Exchange em um recurso do Azure usando o PowerShell

Artigo
03/25/2023

Este artigo descreve como converter um emparelhamento do Exchange herdado existente em um recurso do Azure usando cmdlets do PowerShell.

Se preferir, conclua este guia usando o portal do Azure.

Antes de começar

Examine os pré-requisitos e o Guia passo a passo de emparelhamento do Exchange antes de começar a configuração.

Trabalhar com o Azure PowerShell

Para executar os cmdlets, você pode usar o Azure Cloud Shell, um shell interativo gratuito. Ele tem ferramentas do Azure instaladas e configuradas para usar com sua conta. Selecione Copiar para copiar o código e colá-lo no Cloud Shell. Em seguida, selecione Enter para executá-lo. Há algumas maneiras de inicializar o Cloud Shell:

Método de inicialização	Captura de tela
Abra o Cloud Shell em seu navegador.
Selecione o botão Cloud Shell na barra de ferramentas no canto superior direito do portal do Azure.

Se você não quiser usar o Azure Cloud Shell, poderá instalar o PowerShell localmente em vez disso. Se você optar por instalar e usar o PowerShell localmente, instale a versão mais recente dos cmdlets do PowerShell do Azure Resource Manager. Os cmdlets do PowerShell são atualizados com frequência. Você normalmente precisa atualizar seus cmdlets do PowerShell para obter a funcionalidade mais recente do recurso. Caso contrário, você poderá encontrar problemas.

Para encontrar a versão do PowerShell que você está executando localmente, use o cmdlet 'Get-Module -ListAvailable Az'. Para atualizar, consulte Instalar o módulo do Azure PowerShell. Para obter mais informações, confira como instalar e configurar o Azure PowerShell.

Se você usa o PowerShell no macOS, siga as etapas em Instalando o PowerShell no MacOS.

Converter um emparelhamento do Exchange herdado para um recurso do Azure

Antes de começar a configuração, instale e importe os módulos necessários. Você precisa de privilégios de Administrador para instalar módulos no PowerShell.

Instale e importe o módulo Az.

Install-Module Az -AllowClobber
Import-Module Az

Instale e importe o módulo Az.Peering.

Install-Module -Name Az.Peering -AllowClobber
Import-Module Az.Peering

Verifique se os módulos foram importados corretamente usando este comando:
```
Get-Module
```
Conecte à sua conta do Azure usando este comando:
```
Connect-AzAccount
```
Verifique as assinaturas da conta e selecione a assinatura na qual você quer criar um emparelhamento.
```
Get-AzSubscription
Select-AzSubscription -SubscriptionId "subscription-id"
```
Se você ainda não tiver um grupo de recursos, deverá criar um antes de criar um emparelhamento. Faça isso ao executar o seguinte comando:
```
New-AzResourceGroup -Name "PeeringResourceGroup" -Location "Central US"
```

Importante

Se você ainda não associou o ASN e a assinatura, siga as etapas em Associar ASN de Pares. Essa ação é necessária para solicitar um emparelhamento.

Observação

O local de um grupo de recursos é independente do local em que você opta por configurar um emparelhamento.

Obter o emparelhamento do Exchange herdado para conversão

Este exemplo mostra como obter o emparelhamento do Exchange herdado no local de emparelhamento de Seattle:

$legacyPeering = Get-AzLegacyPeering -Kind Exchange -PeeringLocation "Seattle"
$legacyPeering

A resposta se assemelha à seguinte:

    Kind                     : Exchange
    PeeringLocation          : Seattle
    PeerAsn                  : 65000
    Connection               : ------------------------
    PeerSessionIPv4Address   : 10.21.31.100
    MicrosoftIPv4Address     : 10.21.31.50
    SessionStateV4           : Established
    MaxPrefixesAdvertisedV4  : 20000
    PeerSessionIPv6Address   : fe01::3e:100
    MicrosoftIPv6Address     : fe01::3e:50
    SessionStateV6           : Established
    MaxPrefixesAdvertisedV6  : 2000
    ConnectionState          : Active