Criar ou modificar um emparelhamento do Exchange usando o PowerShell

Artigo
10/26/2023

Este artigo descreve como criar um emparelhamento do Microsoft Exchange usando 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.

Se preferir, você pode concluir este guia usando o portal do Azure.

Antes de começar

Analise os pré-requisitos e o 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 são convertidos em recursos do Azure, consulte Converter um emparelhamento herdado do Exchange em um recurso do Azure usando o PowerShell.

Trabalhar com o Azure PowerShell

Para executar os cmdlets, você pode usar o Azure Cloud Shell, um shell interativo gratuito. Tem as ferramentas comuns do Azure pré-instaladas e configuradas para utilização com a sua conta. Selecione Copiar para copiar o código e cole-o no Cloud Shell. Em seguida, selecione Enter para executá-lo. Existem algumas maneiras de iniciar o Cloud Shell:

Método de lançamento	Captura de ecrã
Abrir o Cloud Shell no seu browser.
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. Se você optar por instalar e usar o PowerShell localmente, certifique-se de instalar a versão mais recente dos cmdlets do PowerShell do Azure Resource Manager. Os cmdlets do PowerShell são atualizados com frequência. Normalmente, você precisa atualizar seus cmdlets do PowerShell para obter a funcionalidade de recurso mais recente. Se não o fizer, poderá encontrar problemas.

Para localizar 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, consulte como instalar e configurar o Azure PowerShell.

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

Criar e provisionar um emparelhamento do Exchange

Antes de iniciar 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
```
Entre na sua conta do Azure usando este comando:
```
Connect-AzAccount
```
Verifique as subscrições da conta e selecione a subscrição na qual pretende 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. Você pode fazer isso executando o seguinte comando:
```
New-AzResourceGroup -Name "PeeringResourceGroup" -Location "Central US"
```

Importante

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

Nota

O local de um grupo de recursos é independente do local onde você escolhe configurar um emparelhamento.

Obter a lista de locais de emparelhamento suportados para emparelhamento do Exchange

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

Get-AzPeeringLocation -Kind "Exchange"

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

Nome do Exchange
EmparelhamentoLocalização
País
PeeringDBFacilityId
PeeringDBFacilityLink
MicrosoftIPv4Endereço
MicrosoftIPv6Address

Valide se você está presente no recurso de emparelhamento desejado consultando PeeringDB.

Este exemplo mostra como usar Seattle como o 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 você estiver usando um provedor diferente e configurações diferentes, substitua essas informações quando fizer sua solicitação.

Use o cmdlet do PowerShell New-AzPeeringExchangeConnectionObject 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 do 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 emparelhamento determinado.

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

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

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

Este exemplo de resposta 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 inicia o provisionamento do emparelhamento solicitado e ConnectionState reflete o progresso. Para obter mais informações sobre etapas relacionadas ao provisionamento, consulte o passo a passo do emparelhamento do Exchange.

Você pode verificar o estado da conexão, como 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 emparelhamento do Exchange

Para obter a lista de pares, 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 suportadas para emparelhamento do Exchange:

Adicione conexões de emparelhamento do Exchange.
Remova as conexões de emparelhamento do Exchange.
Adicione uma sessão IPv4 ou IPv6 em conexões ativas.
Remova 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 emparelhamento do Exchange

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


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

Veja todas as ligações e selecione a ligação que pretende 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 de índice da conexão que você 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

A remoção de uma sessão IPv4 ou IPv6 de uma conexão existente não é suportada atualmente no PowerShell. Para obter mais informações, contate o emparelhamento da Microsoft.

Desprovisionar um emparelhamento do Exchange

Atualmente, não há suporte para o desprovisionamento usando o portal do Azure ou o PowerShell. Para desprovisionar, contate o emparelhamento da Microsoft.

Recursos adicionais

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

Get-Help Get-AzPeering -detailed

Próximos passos

Crie ou modifique um emparelhamento direto usando o PowerShell.
Converter um emparelhamento direto herdado em um recurso do Azure usando o PowerShell.
Perguntas frequentes (FAQ) sobre emparelhamento na Internet.

Partilhar via

Criar ou modificar um emparelhamento do Exchange usando o PowerShell

Antes de começar

Trabalhar com o Azure PowerShell

Criar e provisionar um emparelhamento do Exchange

Obter a lista de locais de emparelhamento suportados para emparelhamento do Exchange

Criar um emparelhamento do Exchange

Obter emparelhamento do Exchange

Modificar um emparelhamento do Exchange

Adicionar conexões de emparelhamento do Exchange

Remover 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

Desprovisionar um emparelhamento do Exchange

Recursos adicionais

Próximos passos

Comentários

Recursos adicionais

Partilhar via

Criar ou modificar um emparelhamento do Exchange usando o PowerShell

Antes de começar

Trabalhar com o Azure PowerShell

Criar e provisionar um emparelhamento do Exchange

Inicie sessão na sua conta do Azure e selecione a sua subscrição

Obter a lista de locais de emparelhamento suportados para emparelhamento do Exchange

Criar um emparelhamento do Exchange

Obter emparelhamento do Exchange

Modificar um emparelhamento do Exchange

Adicionar conexões de emparelhamento do Exchange

Remover 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

Desprovisionar um emparelhamento do Exchange

Recursos adicionais

Próximos passos

Comentários

Recursos adicionais