Criar ou modificar um Emparelhamento direto com o PowerShell

Este artigo descreve como criar um Emparelhamento direto da Microsoft usando os cmdlets do PowerShell e o modelo de implantação do Azure 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 direto antes de começar a configuração.
• Se você já tiver conexões de emparelhamento direto com a Microsoft que não são convertidas nos recursos do Azure, veja Converter um Emparelhamento direto herdado 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. 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 Direto

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.

1. Instale e importe o módulo Az.

   Install-Module Az -AllowClobber
   Import-Module Az
   

2. Instale e importe o módulo Az.Peering.

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

3. Verifique se os módulos foram importados corretamente usando este comando:

   Get-Module
   

4. Conecte à sua conta do Azure usando este comando:

   Connect-AzAccount
   

5. Verifique as assinaturas da conta e selecione a assinatura na qual você quer criar um emparelhamento.

   Get-AzSubscription
   Select-AzSubscription -SubscriptionId "subscription-id"
   

6. 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"
   

Obter a lista de locais de emparelhamento com suporte para o Emparelhamento direto

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 Direct

Os locais de emparelhamento direto contêm os seguintes campos:

• PeeringLocation
• País/região
• PeeringDBFacilityId
• PeeringDBFacilityLink
• BandwidthOffers

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 Direto.

$peeringLocations = Get-AzPeeringLocation -Kind Direct
$peeringLocation = $peeringLocations | where {$_.PeeringLocation -contains "Seattle"}
$peeringLocation

PeeringLocation       : Seattle
Address               : 2001 Sixth Avenue
Country               : US
PeeringDBFacilityId   : 71
PeeringDBFacilityLink : https://www.peeringdb.com/fac/71
BandwidthOffers       : {10Gbps, 100Gbps}

Criar um emparelhamento Direto

O exemplo a seguir mostra como criar um emparelhamento direto de 10 Gbps em Seattle.

Use o cmdlet New-AzPeeringDirectConnectionObject do PowerShell para criar objetos DirectConnection que serão usados na nova solicitação de emparelhamento.

Este exemplo mostra como criar um objeto DirectConnection.

$connection1 = New-AzPeeringDirectConnectionObject `
    -PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
    -SessionPrefixV4 10.21.31.0/31 `
    -SessionPrefixV6 fe01::3e:0/127 `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

Crie outra conexão caso você precise de redundância em um determinado local de emparelhamento.

$connection2 = New-AzPeeringDirectConnectionObject `
    -PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
    -SessionPrefixV4 10.21.33.0/31 `
    -SessionPrefixV6 fe01::3f:0/127 `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

Use o cmdlet New-AzPeering do PowerShell para criar um novo emparelhamento direto. Este comando requer uma ID de recurso ASN, que pode ser recuperada como mostrado aqui.

$asn = Get-AzPeerAsn
New-AzPeering `
    -Name "SeattleDirectPeering" `
    -ResourceGroupName "PeeringResourceGroup" `
    -PeeringLocation  $peeringLocation[0].PeeringLocation `
    -PeerAsnResourceId $asn.Id `
    -DirectConnection $connection1 [, $connection2]

Este exemplo mostra a resposta quando a solicitação foi processada com êxito.

    Name                 : SeattleDirectPeering
    Sku.Name             : Basic_Direct_Free
    Kind                 : Direct
    Connections          : 71
    PeerAsn.Id           : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/SeattleDirectPeering
    UseForPeeringService : False
    PeeringLocation      : Seattle
    ProvisioningState    : Succeeded
    Location             : centralus
    Id                   : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
    Type                 : Microsoft.Peering/peerings
    Tags                 : {}

Observe que, no lugar de {subscriptionId} na saída acima, será exibida a ID da assinatura real.

Verificar emparelhamento Direto

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

$directPeering = Get-AzPeering -ResourceGroupName "PeeringResourceGroup" -Name "SeattleDirectPeering"

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

    Name                 : SeattleDirectPeering
    Sku.Name             : Basic_Direct_Free
    Kind                 : Direct
    Connections          : {71}
    PeerAsn.Id           : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/SeattleDirectPeering
    UseForPeeringService : False
    PeeringLocation      : Seattle
    ProvisioningState    : Succeeded
    Location             : centralus
    Id                   : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
    Type                 : Microsoft.Peering/peerings
    Tags                 : {}

Modificar um emparelhamento Direto

Esta seção descreve como executar as seguintes operações de modificação para emparelhamento direto:

• Adicionar conexões de emparelhamento direto.
• Remover Conexões de emparelhamento direto.
• Atualizar ou fazer downgrade da largura de banda em Conexões ativas.
• Adicionar sessões IPv4 ou IPv6 em Conexões ativas.
• Remover sessões IPv4 ou IPv6 em Conexões ativas.

Adicionar conexões de emparelhamento direto

Este exemplo descreve como adicionar conexões ao emparelhamento direto existente.

$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"

$connection = New-AzPeeringDirectConnection `
    -PeeringDBFacilityId $peeringLocation.PeeringDBFacilityId `
    -SessionPrefixV4 "10.22.31.0/31" `
    -SessionPrefixV6 "fe02::3e:0/127" `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

$directPeering.Connections.Add($connection)

$directPeering | Update-AzPeering

Remover Conexões de emparelhamento direto

No momento, não há suporte para a remoção de uma conexão no PowerShell. Para obter mais informações, entre em contato com Emparelhamento da Microsoft.

Atualizar ou fazer downgrade da largura de banda em Conexões ativas

Este exemplo descreve como adicionar 10 Gbps a uma conexão direta existente.

$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BandwidthInMbps  = 20000
$directPeering | Update-AzPeering

Adicionar sessões IPv4 ou IPv6 em Conexões ativas

Este exemplo descreve como adicionar uma sessão IPv6 em uma conexão direta existente com apenas uma sessão IPv4.

$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BGPSession.SessionPrefixv6 = "fe01::3e:0/127"
$directPeering | Update-AzPeering

Remover sessões 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 Direto

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

Próximas etapas

• Criar ou modificar o emparelhamento do Exchange usando o PowerShell.
• Converter um emparelhamento do Exchange herdado em um recurso do Azure com o PowerShell.
• Perguntas frequentes sobre emparelhamento de Internet.