Compartir vía

Crear o modificar un emparejamiento directo utilizando PowerShell

En este artículo se describe cómo crear un Microsoft Direct Peering mediante los 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.

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 Copiar para copiar el código y péguelo en Cloud Shell. A continuación, 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
Seleccione el botón Cloud Shell de la barra de herramientas de la esquina 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 buscar la versión de PowerShell que está ejecutando localmente, use el cmdlet "Get-Module -ListAvailable Az ". Para actualizarlo, consulte Instalación del módulo de Azure PowerShell. Para más información, consulte cómo instalar y configurar Azure PowerShell.

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

Crear y aprovisionar 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 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 descritos en Asociar ASN de pares. 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.  

Obtención de la lista de ubicaciones de emparejamiento compatibles para el emparejamiento directo

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

Get-AzPeeringLocation -Kind Direct

Las ubicaciones de emparejamiento directo contienen los siguientes campos:

  • Ubicación de Peering
  • País
  • PeeringDBFacilityId
  • PeeringDBFacilityLink
  • Ofertas de Ancho de Banda

Compruebe que está presente en la instalación de peering deseada consultando 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}

Cree un emparejamiento directo

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

Use el cmdlet de PowerShell New-AzPeeringDirectConnectionObject para crear objetos DirectConnection que se usarán 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 que prefiera.

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

Utilice el cmdlet de PowerShell New-AzPeering para crear un nuevo 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                 : {}

Tenga en cuenta que en lugar de {subscriptionId} en esta salida, se mostrará el identificador de suscripción real.

Verificar emparejamiento directo

Para obtener la lista de emparejamientos por pares, 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                 : {}

Modificar un emparejamiento directo

En esta sección se describe cómo realizar las siguientes operaciones de modificación para Direct Peering:

  • Añade conexiones de emparejamiento directo
  • Eliminación de conexiones de emparejamiento directo
  • Aumentar o disminuir el ancho de banda en conexiones activas.
  • Adición de sesiones IPv4 o IPv6 en conexiones activas
  • Eliminación de sesiones IPv4 o IPv6 en conexiones activas

Añadir 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 obtener más información, póngase en contacto con interconexión de Microsoft.

Aumento o reducción 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 obtener más información, póngase en contacto con peering de Microsoft.

Desconfiguración de un emparejamiento de red directa

Actualmente, el desaprovisionamiento no se admite mediante Azure Portal ni PowerShell. Para desaprovisionar, póngase en contacto con Microsoft Peering.

Recursos adicionales

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

Get-Help Get-AzPeering -detailed

Pasos siguientes