Compartir vía

Convertir un emparejamiento directo heredado en un recurso de Azure mediante PowerShell

En este artículo se explica cómo convertir un emparejamiento directo heredado existente en un recurso de Azure utilizando los cmdlets de PowerShell.

Antes de empezar

Funcionamiento con Azure PowerShell

Para ejecutar los cmdlets, puede usar Azure Cloud Shell, un shell interactivo gratuito. Tiene herramientas comunes de Azure preinstaladas y configuradas para usarlas con su cuenta. Seleccione Copy (Copiar) para copiar el código y péguelo en Cloud Shell. Seleccione Entrar para ejecutarlo. Hay unas cuantas maneras de iniciar Cloud Shell:

Método de inicio Captura de pantalla
Abra Cloud Shell en el explorador. https://shell.azure.com/powershell
Haga clic en el botón Cloud Shell en la barra de herramientas en la parte superior derecha de Azure Portal. Cloud Shell en el portal

Si no desea usar Azure Cloud Shell, puede instalar PowerShell localmente en su lugar. Si elige instalar y usar PowerShell de forma local, asegúrese de instalar la versión más reciente de los cmdlets de PowerShell de Azure Resource Manager. Los cmdlets de PowerShell se actualizan con frecuencia. Normalmente necesita actualizar los cmdlets de PowerShell para obtener la funcionalidad más reciente de la característica. Si no lo hace, puede encontrarse con problemas.

Para encontrar la versión de PowerShell que se ejecuta localmente, use el cmdlet "Get-Module -ListAvailable Az". Para realizar la actualización, consulte Instalación del módulo de Azure PowerShell. Para más información, consulte Instalación y configuración de Azure PowerShell.

Si usa PowerShell en macOS, siga los pasos descritos en Instalación de PowerShell en macOS.

Conversión de un emparejamiento directo heredado en un recurso de Azure

Iniciar sesión en la cuenta de Azure y seleccione la suscripción

Antes de comenzar la configuración, instale e importe los módulos necesarios. Necesitará privilegios de administrador para instalar los módulos en PowerShell.

  1. Instale e importe el módulo Az

    Install-Module Az -AllowClobber
Import-Module Az

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

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

  3. Use este comando para comprobar que los módulos se importaron correctamente:

    Get-Module

  4. Inicie sesión en su cuenta de Azure mediante este comando:

    Connect-AzAccount

  5. Compruebe las suscripciones de la cuenta y seleccione la suscripción en la que desea crear una vinculación.

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

  6. Si todavía no tiene un grupo de recursos, debe crear uno antes de establecer una vinculación. Para ello, ejecute el siguiente comando:

    New-AzResourceGroup -Name "PeeringResourceGroup" -Location "Central US"

Importante

Si aún no ha asociado su ASN y suscripción, siga los pasos que se indican en Asociar ASN de Par. Esta acción es necesaria para solicitar un emparejamiento.

Nota:

La ubicación de un grupo de recursos es independiente de la ubicación donde elija configurar un emparejamiento.  

Obtener un enlace directo legado para la conversión

En este ejemplo se muestra cómo obtener un emparejamiento directo heredado en la ubicación de emparejamiento de Seattle.

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

Esta es una respuesta de ejemplo:

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

Convierte un peering directo heredado

 

Importante

Al convertir un emparejamiento heredado en un recurso de Azure, no se admiten modificaciones.  

Use este comando para convertir un emparejamiento directo heredado en un recurso de Azure:

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

Esta es una respuesta de ejemplo:

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 adicionales

Para obtener descripciones detalladas de todos los parámetros, ejecute este comando:

Get-Help Get-AzPeering -detailed

Pasos siguientes

  • Last updated on