Compartilhar via

Converter um emparelhamento direto herdado em um recurso do Azure usando o PowerShell

  • Artigo

Este artigo descreve como converter um emparelhamento do Direct herdado existente para um recurso do Azure usando cmdlets do PowerShell.

Se preferir, conclua 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. 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
Abra o Cloud Shell em seu navegador. 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 in the portal

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.

Converter um emparelhamento direto herdado em um recurso do Azure

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"

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 um emparelhamento do Direct herdado para conversão

Este exemplo mostra como obter o emparelhamento do Direct herdado no local de emparelhamento de Seattle.

$legacyPeering = Get-AzLegacyPeering `
    -Kind Direct -PeeringLocation "Seattle"
$legacyPeering

Eis uma resposta de exemplo:

Name                       :
Sku                        : Basic_Direct_Free
Kind                       : Direct
PeeringLocation            : Seattle
UseForPeeringService       : False
PeerAsn.Id                 :
Connection                 : ------------------------
PeeringDBFacilityId        : 71
SessionPrefixIPv4          : 4.71.156.72/30
PeerSessionIPv4Address     : 4.71.156.73
MicrosoftIPv4Address       : 4.71.156.74
SessionStateV4             : Established
MaxPrefixesAdvertisedV4    : 20000
SessionPrefixIPv6          : 2001:1900:2100::1e10/126
MaxPrefixesAdvertisedV6    : 2000
ConnectionState            : Active
BandwidthInMbps            : 0
ProvisionedBandwidthInMbps : 20000
Connection                 : ------------------------
PeeringDBFacilityId        : 71
SessionPrefixIPv4          : 4.68.70.140/30
PeerSessionIPv4Address     : 4.68.70.141
MicrosoftIPv4Address       : 4.68.70.142
SessionStateV4             : Established
MaxPrefixesAdvertisedV4    : 20000
SessionPrefixIPv6          : 2001:1900:4:3::cc/126
PeerSessionIPv6Address     : 2001:1900:4:3::cd
MicrosoftIPv6Address       : 2001:1900:4:3::ce
SessionStateV6             : Established
MaxPrefixesAdvertisedV6    : 2000
ConnectionState            : Active
BandwidthInMbps            : 0
ProvisionedBandwidthInMbps : 20000
ProvisioningState          : Succeeded

Converter um emparelhamento direto herdado

 

Importante

Quando você converte um emparelhamento herdado em um recurso do Azure, não há suporte para modificações.  

Use este comando para converter um emparelhamento direto herdado em um recurso do Azure:

$legacyPeering[0] | New-AzPeering `
    -Name "SeattleDirectPeering" `
    -ResourceGroupName "PeeringResourceGroup" `

Eis uma resposta de exemplo:

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

Recursos adicionais

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

Get-Help Get-AzPeering -detailed

Próximas etapas