Partilhar via

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

  • Artigo

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

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 in the 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.

Converter um emparelhamento direto herdado em um recurso do Azure

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.  

Obtenha um emparelhamento direto herdado para conversão

Este exemplo mostra como obter um emparelhamento direto 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, as modificações não são suportadas.  

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óximos passos