Crie ou modifique um emparelhamento Exchange usando o PowerShell
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, 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.
- 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 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 |
|---|---|
| Abrir o Cloud Shell no 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 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.
Criar e provisionar um emparelhamento do Exchange
Entre na sua conta do Azure e selecione sua assinatura
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 AzInstale e importe o módulo Az.Peering.
Install-Module -Name Az.Peering -AllowClobber Import-Module Az.PeeringVerifique se os módulos foram importados corretamente usando este comando:
Get-ModuleConecte à sua conta do Azure usando este comando:
Connect-AzAccountVerifique 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 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
- PeeringLocation
- País/região
- PeeringDBFacilityId
- PeeringDBFacilityLink
- MicrosoftIPv4Address
- MicrosoftIPv6Address
Valide se você está na instalação de emparelhamento desejada fazendo referência a 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 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 emparelhamento fornecido.
$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 emparelhamento do 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 o emparelhamento solicitado 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 emparelhamento do Exchange
Para obter a lista de emparelhamentos, 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 emparelhamento do Exchange:
- Adicionar conexões de emparelhamento 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 emparelhamento 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 Emparelhamento da Microsoft.
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 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