Partilhar via

Criar ou modificar um emparelhamento direto usando o PowerShell

  • Artigo

Este artigo descreve como criar um emparelhamento do Microsoft Direct usando 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, você pode concluir este guia usando o portal do Azure.

Antes de começar

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. https://shell.azure.com/powershell
Selecione o botão Cloud Shell na barra de ferramentas no canto superior direito do portal do Azure. Cloud Shell no portal

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 direto

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

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.

  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. Entre na sua conta do Azure usando este comando:

    Connect-AzAccount

  5. Verifique as subscrições da conta e selecione a subscrição na qual pretende 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. 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 direto

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 Direct

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

  • EmparelhamentoLocalização
  • País
  • PeeringDBFacilityId
  • PeeringDBFacilityLink
  • Largura de bandaOfertas

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 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 do PowerShell New-AzPeeringDirectConnectionObject para criar objetos DirectConnection que devem ser 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

Nota

O valor para $peeringLocation[] no exemplo anterior deve corresponder ao local de emparelhamento de sua escolha.

Crie outra conexão caso 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 do PowerShell New-AzPeering para criar um novo emparelhamento direto. Este comando requer um ID de recurso ASN, que pode ser recuperado 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} nesta saída, o ID de assinatura real será exibido.

Verificar emparelhamento direto

Para obter a lista de pares, 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:

  • Adicione conexões diretas de emparelhamento.
  • Remova as conexões diretas de emparelhamento.
  • Atualize ou faça downgrade da largura de banda em conexões ativas.
  • Adicione sessões IPv4 ou IPv6 em conexões ativas.
  • Remova sessões IPv4 ou IPv6 em conexões ativas.

Adicionar conexões diretas de emparelhamento

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 diretas de emparelhamento

Atualmente, não há suporte para a remoção de uma conexão no PowerShell. Para obter mais informações, contate o 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 Direct 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 Direct 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

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 direto

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