Compartir vía

Creación o modificación de un emparejamiento directo mediante PowerShell

  • Artículo

En este artículo se describe cómo crear un emparejamiento directo de Microsoft mediante cmdlets de PowerShell y el modelo de implementación de Azure Resource Manager. También se muestra cómo comprobar el estado del recurso, así como la forma de actualizarlo o eliminarlo y desaprovisionarlo.

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.

Creación y aprovisionamiento de un emparejamiento directo

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 de la lista de ubicaciones de emparejamiento compatibles para el emparejamiento directo

El cmdlet Get-AzPeeringLocation de PowerShell devuelve una lista de ubicaciones de emparejamiento con el parámetro obligatorio Kind, que se usará en pasos posteriores:

Get-AzPeeringLocation -Kind Direct

Las ubicaciones de emparejamiento directo contienen los siguientes campos:

  • PeeringLocation
  • Country
  • PeeringDBFacilityId
  • PeeringDBFacilityLink
  • BandwidthOffers

Para comprobar que está presente en la instalación de emparejamiento deseada, consulte PeeringDB.

En este ejemplo se muestra cómo usar Seattle como ubicación de emparejamiento para crear un emparejamiento directo.

$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}

Creación de un emparejamiento directo

En el ejemplo siguiente se muestra cómo crear un emparejamiento directo de 10 Gbps en Seattle.

Use el cmdlet New-AzPeeringDirectConnectionObject de PowerShell para crear objetos DirectConnection para usarlos en la nueva solicitud de emparejamiento.

En este ejemplo se muestra cómo crear un 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:

El valor de $peeringLocation[] del ejemplo anterior debe corresponder a la ubicación de emparejamiento de su elección.

Cree otra conexión si necesita redundancia en la ubicación de emparejamiento dada.

$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 el cmdlet New-AzPeering de PowerShell para crear un emparejamiento directo. Este comando requiere un identificador de recurso de ASN que se puede recuperar, como se muestra aquí.

$asn = Get-AzPeerAsn
New-AzPeering `
    -Name "SeattleDirectPeering" `
    -ResourceGroupName "PeeringResourceGroup" `
    -PeeringLocation  $peeringLocation[0].PeeringLocation `
    -PeerAsnResourceId $asn.Id `
    -DirectConnection $connection1 [, $connection2]

 

En este ejemplo se muestra la respuesta cuando la solicitud se ha procesado correctamente:


    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, en esta salida, se muestra el identificador de suscripción real en lugar de {subscriptionId}.

Comprobación del emparejamiento directo

Para obtener la lista de emparejamientos, ejecute el comando Get-AzPeering.

$directPeering = Get-AzPeering -ResourceGroupName "PeeringResourceGroup" -Name "SeattleDirectPeering"

En el ejemplo siguiente se muestra la respuesta cuando el aprovisionamiento de un extremo a otro se ha completado correctamente.

    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                 : {}

Modificación de un emparejamiento directo

En esta sección se describe cómo realizar las siguientes operaciones de modificación para el emparejamiento directo:

  • Adición de conexiones de emparejamiento directo
  • Eliminación de conexiones de emparejamiento directo
  • Actualización o cambio a una versión anterior del ancho de banda en las conexiones activas
  • Adición de sesiones IPv4 o IPv6 en conexiones activas
  • Eliminación de sesiones IPv4 o IPv6 en conexiones activas

Adición de conexiones de emparejamiento directo

En el ejemplo siguiente se describe cómo agregar conexiones a un emparejamiento directo 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

Eliminación de conexiones de emparejamiento directo

La eliminación de una conexión no se admite actualmente en PowerShell. Para más información, póngase en contacto con el servicio de emparejamiento de Microsoft.

Actualización o cambio a una versión anterior del ancho de banda en las conexiones activas

En este ejemplo se describe cómo agregar 10 Gbps a una conexión directa existente.


$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BandwidthInMbps  = 20000
$directPeering | Update-AzPeering

Adición de sesiones IPv4 o IPv6 en conexiones activas

En este ejemplo se describe cómo agregar una sesión IPv6 en una conexión directa existente solo con una sesión IPv4.


$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BGPSession.SessionPrefixv6 = "fe01::3e:0/127"
$directPeering | Update-AzPeering

Eliminación de sesiones IPv4 o IPv6 en conexiones activas

Eliminar una sesión IPv4 o IPv6 de una conexión existente no se admite actualmente en PowerShell. Para más información, póngase en contacto con el servicio de emparejamiento de Microsoft.

Desaprovisionamiento de un emparejamiento directo

En este momento, no se admite el desaprovisionamiento mediante Azure Portal o PowerShell. Para hacerlo, póngase en contacto con el servicio de emparejamiento de Microsoft.

Recursos adicionales

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

Get-Help Get-AzPeering -detailed

Pasos siguientes