Crie ou modifique um emparelhamento Exchange usando o PowerShell

2023-01-23

Este artigo descreve como criar um emparelhamento Microsoft Exchange utilizando cmdlets do PowerShell e o modelo de implantação do Resource Manager. Este artigo também mostra como verificar o status do recurso, atualizá-lo ou excluí-lo e desprovisioná-lo.

Antes de começar

Revise os pré-requisitos e o Guia passo a passo de emparelhamento do Exchange antes de iniciar a configuração.
Se você já tiver emparelhamentos do Exchange com a Microsoft que não foram convertidos em recursos do Azure, confira Converter um emparelhamento do Exchange herdado em um recurso do Azure com o uso do PowerShell.

Trabalhar com o Azure PowerShell

Para executar os cmdlets, você pode usar o Azure Cloud Shell, um shell interativo gratuito. Ele tem ferramentas comuns do Azure pré-instaladas e configuradas para uso 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. Se você não fizer isso, 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.

Criação e provisionamento de um emparelhamento de Exchange

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 em que você deseja 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 pareamento. 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 Peer ASN. Essa ação é necessária para solicitar um emparelhamento.

Observação

A localização de um grupo de recursos é independente da localização em que você opta por configurar um emparelhamento.

Obter a lista de locais de emparelhamentos com suporte para o emparelhamento do Exchange

O cmdlet Get-AzPeeringLocation do PowerShell retorna uma lista de locais de emparelhamento com o parâmetro obrigatório Kind, que você usará em etapas posteriores.

Get-AzPeeringLocation -Kind "Exchange"

Os locais de emparelhamento do Exchange contêm os seguintes campos:

ExchangeName
Localização de Peering
País
PeeringDBFacilityId
PeeringDBFacilityLink
MicrosoftIPv4Address
MicrosoftIPv6Address

Valide se você está na instalação de emparelhamento desejada consultando o PeeringDB.

Este exemplo mostra como usar Seattle como local de emparelhamento para criar um emparelhamento.

$exchangeLocations = Get-AzPeeringLocation -Kind Exchange
$exchangeLocation = $exchangeLocations | where {$_.PeeringLocation -eq "Seattle"}

#check the location metadata
$exchangeLocation

ExchangeName          : Columbia IX
PeeringLocation       : Seattle
Country               : US
PeeringDBFacilityId   : 99999
PeeringDBFacilityLink : https://www.peeringdb.com/ix/99999
MicrosoftIPv4Address  : 10.12.97.129
MicrosoftIPv6Address  :

ExchangeName          : Equinix Seattle
PeeringLocation       : Seattle
Country               : US
PeeringDBFacilityId   : 11
PeeringDBFacilityLink : https://www.peeringdb.com/ix/11
MicrosoftIPv4Address  : 198.32.134.152
MicrosoftIPv6Address  : 2001:504:12::15

...

Criar um emparelhamento do Exchange

O exemplo a seguir mostra como criar uma conexão do Exchange no Equinix Internet Exchange em Seattle. Se estiver usando um provedor diferente e configurações diferentes, substitua essas informações ao fazer a solicitação.

Use o cmdlet New-AzPeeringExchangeConnectionObject do PowerShell para criar objetos de conexão do PowerShell, que serão usados para gerar a nova solicitação de emparelhamento.

Este exemplo mostra como criar uma conexão Exchange.

$connection1 = New-AzPeeringExchangeConnectionObject `
    -PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
    -PeerSessionIPv4Address 198.32.134.22 `
    -PeerSessionIPv6Address  2001:504:12::22 `
    -MaxPrefixesAdvertisedIPv4 2000 `
    -MaxPrefixesAdvertisedIPv6 2000 `

Crie outra conexão caso precise de redundância no local de peering especificado.

$connection2 = New-AzPeeringExchangeConnectionObject `
    -PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
    -PeerSessionIPv4Address 198.32.134.23 `
    -PeerSessionIPv6Address  2001:504:12::23 `
    -MaxPrefixesAdvertisedIPv4 2000 `
    -MaxPrefixesAdvertisedIPv6 2000 `

O cmdlet New-AzPeering do PowerShell pode ser usado para criar um novo peering de Exchange.

$asn = Get-AzPeerAsn
New-AzPeering `
    -Name "SeattleExchangePeering" `
    -ResourceGroupName "PeeringResourceGroup" `
    -PeerAsnResourceId $asn.Id `
    -PeeringLocation  $exchangeLocation[1].PeeringLocation `
    -ExchangeConnection $connection1[, $connection2]

Esta resposta de exemplo mostra quando a solicitação foi executada usando uma conexão.


Name              : SeattleExchangePeering
Sku.Name          : Basic_Exchange_Free
Kind              : Exchange
Connections       : {11}
PeerAsn.Id        : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{peerAsnName}
PeeringLocation   : Seattle
ProvisioningState : Succeeded
Location          : West US 2
Id                : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleExchangePeering
Type              : Microsoft.Peering/peerings
Tags              : {}

Importante

A Microsoft começa a provisionar a conexão solicitada e ConnectionState reflete o progresso. Para obter mais informações sobre as etapas relacionadas ao provisionamento, consulte o passo a passo de emparelhamento do Exchange.

Você pode verificar o estado da conexão, conforme mostrado aqui.


$peering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
$peering.Connections

PeeringDBFacilityId         : 11
PeerSessionIPv4Address      : 198.32.134.22
PeerSessionIPv6Address      : 2001:504:12::22
SessionStateV4              : PendingAdd
SessionStateV6              : PendingAdd
MaxPrefixesAdvertisedV4     : 2000
MaxPrefixesAdvertisedV6     : 2000
MicrosoftSessionIPv4Address : 198.32.134.152
MicrosoftSessionIPv4Address : 2001:504:12::15
Md5AuthenticationKey        :

Obter o pareamento do Exchange

Para obter a lista de pareamentos, execute o comando Get-AzPeering.

Get-AzPeering ResourceGroupName "PeeringResourceGroup" -Name "SeattleExchangePeering"

Este exemplo de resposta mostra quando o provisionamento de ponta a ponta foi concluído com êxito.

    Name                     : SeattleExchangePeering
    Sku                      : Basic_Exchange_Free
    Kind                     : Exchange
    PeeringLocation          : Seattle
    ProvisioningState        : Succeeded
    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
    Connection               : ------------------------
    PeerSessionIPv4Address   : 10.21.31.101
    MicrosoftIPv4Address     : 10.21.31.51
    SessionStateV4           : Established
    MaxPrefixesAdvertisedV4  : 20000
    PeerSessionIPv6Address   : fe01::3e:101
    MicrosoftIPv6Address     : fe01::3e:51
    SessionStateV6           : Established
    MaxPrefixesAdvertisedV6  : 2000
    ConnectionState          : Active

Modificar um emparelhamento do Exchange

As seguintes operações de modificação são compatíveis com o pareamento do Exchange:

Adicionar conexões de peering do Exchange.
Remover as conexões de emparelhamento do Exchange.
Adicionar uma sessão IPv4 ou IPv6 em conexões ativas.
Remover uma sessão IPv4 ou IPv6 em conexões ativas.

Adicionar conexões de emparelhamento do Exchange

Este exemplo descreve como adicionar conexões a um emparelhamento existente do Exchange.


$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"

$connection = New-AzPeeringExchangeConnectionObject `
    -PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
    -PeerSessionIPv4Address 198.32.134.22 `
    -PeerSessionIPv6Address  2001:504:12::22 `
    -MaxPrefixesAdvertisedIPv4 2000 `
    -MaxPrefixesAdvertisedIPv6 2000 `

$exchangePeering.Connections.Add($connection)

$exchangePeering | Update-AzPeering

Remover Conexões de Peering do Exchange

Este exemplo descreve como remover conexões a um emparelhamento existente do Exchange.


$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"

Visualize todas as conexões e selecione aquela que deseja remover.


$exchangePeering

Name              : SeattleExchangePeering
Sku.Name          : Basic_Exchange_Free
Kind              : Exchange
Connections       : {11}
PeerAsn.Id        : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{peerAsnName}
PeeringLocation   : Seattle
ProvisioningState : Succeeded
Location          : West US 2
Id                : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleExchangePeering
Type              : Microsoft.Peering/peerings
Tags              : {}

No comando a seguir, em vez de 0, insira o número do índice para a conexão que deseja remover.


$connection = $exchangePeering.Connections[0]

$exchangePeering.Connections.Remove($connection)

$exchangePeering | Update-AzPeering

Adicionar uma sessão IPv4 ou IPv6 em conexões ativas

Este exemplo descreve como adicionar uma sessão IPv6 a uma conexão existente do Exchange.


$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"

$exchangePeering.Connections[0].BgpSession.PeerSessionIPv6Address = "2001:504:12::34"

$exchangePeering | Update-AzPeering

Remover uma sessão IPv4 ou IPv6 em Conexões ativas

Atualmente, não há suporte para a remoção de uma sessão IPv4 ou IPv6 de uma conexão existente no PowerShell. Para obter mais informações, entre em contato com Microsoft Peering.

Desprovisionar um emparelhamento do Exchange

No momento, o desprovisionamento não tem suporte usando o portal do Azure ou o PowerShell. Para desprovisionar, entre em contato com o peering da Microsoft.

Recursos adicionais

Você pode obter descrições detalhadas de todos os parâmetros executando o seguinte comando:

Get-Help Get-AzPeering -detailed

Compartilhar via

Crie ou modifique um emparelhamento Exchange usando o PowerShell

Antes de começar

Trabalhar com o Azure PowerShell

Criação e provisionamento de um emparelhamento de Exchange

Entre na sua conta do Azure e selecione sua assinatura

Obter a lista de locais de emparelhamentos com suporte para o emparelhamento do Exchange

Criar um emparelhamento do Exchange

Obter o pareamento do Exchange

Modificar um emparelhamento do Exchange

Adicionar conexões de emparelhamento do Exchange

Remover Conexões de Peering do Exchange

Adicionar uma sessão IPv4 ou IPv6 em conexões ativas

Remover uma sessão IPv4 ou IPv6 em Conexões ativas

Desprovisionar um emparelhamento do Exchange

Recursos adicionais

Próximas etapas

Recursos adicionais