Compartir vía

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

  • Artículo

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

Si lo prefiere, puede realizar los pasos de esta guía mediante Azure Portal.

Antes de empezar

Funcionamiento con Azure PowerShell

Para ejecutar los cmdlets, puede usar Azure Cloud Shell, un shell interactivo gratuito. Tiene las herramientas comunes de Azure preinstaladas y configuradas para usarlas en la 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 in the 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 un emparejamiento.

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

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

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

Importante

Si aún no ha asociado el ASN y la suscripción, siga los pasos que se indican en Asociación del ASN del mismo nivel. Esta acción es necesaria para solicitar un emparejamiento.

Nota:

La ubicación del grupo de recursos es independiente de la ubicación en la que decida configurar un emparejamiento.  

Obtención del emparejamiento directo heredado para la conversión

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

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

Este es un ejemplo de respuesta:

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

Conversión de un emparejamiento directo heredado

 

Importante

Cuando convierte el emparejamiento heredado en un recurso de Azure, no se admiten las modificaciones.  

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

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

Este es un ejemplo de respuesta:

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

Puede obtener una descripción detallada de todos los parámetros ejecutando este comando:

Get-Help Get-AzPeering -detailed

Pasos siguientes