Créer ou modifier un Peering direct à l’aide de PowerShell

• Azure portal
• PowerShell

Cet article explique comment créer un Peering direct Microsoft à l’aide de cmdlets PowerShell et du modèle de déploiement Azure Resource Manager. Il montre également comment vérifier l’état de la ressource, la mettre à jour, la supprimer et la déprovisionner.

Si vous préférez, vous pouvez suivre ce guide en utilisant le Portail Azure.

Avant de commencer

• Passez en revue les prérequis et la procédure pas à pas du Peering direct avant de commencer la configuration.
• Si vous avez déjà des connexions de Peering direct avec Microsoft qui ne sont pas converties en ressources Azure, consultez Convertir un Peering direct hérité en ressource Azure à l’aide de PowerShell.

Utiliser Azure PowerShell

Pour exécuter les cmdlets, vous pouvez utiliser Azure Cloud Shell, un interpréteur de commandes interactif gratuit. Il contient des outils Azure courants préinstallés et configurés pour être utilisés avec votre compte. Sélectionnez Copier pour copier le code, puis collez-le dans Cloud Shell. Appuyez ensuite sur la touche Entrée pour l’exécuter. Cloud Shell peut être lancé de plusieurs façons :

Méthode de lancement	Capture d'écran
Ouvrez Cloud Shell dans votre navigateur.
Sélectionnez le bouton Cloud Shell dans la barre d’outils située dans l’angle supérieur droit du Portail Azure.

Si vous ne souhaitez pas utiliser Azure Cloud Shell, vous pouvez installer PowerShell localement. Si vous choisissez d’installer et d’utiliser PowerShell localement, veillez à installer la dernière version des cmdlets PowerShell Azure Resource Manager. Les cmdlets PowerShell sont fréquemment mises à jour. Vous devez généralement mettre à jour les vôtres pour obtenir les toutes dernières fonctionnalités. Si vous ne le faites pas, vous risquez de rencontrer des problèmes.

Pour déterminer la version de PowerShell que vous exécutez localement, utilisez la cmdlet « Get-Module -ListAvailable Az ». Pour mettre à jour, consultez Installer le module Azure PowerShell. Pour plus d’informations, consultez Installer et configurer Azure PowerShell.

Si vous utilisez PowerShell sur macOS, suivez les étapes décrites dans Installation de PowerShell sur macOS.

Créer et approvisionner un Peering direct

Vous connecter à votre compte Azure et sélectionner votre abonnement

Avant de commencer la configuration, installez et importez les modules requis. Vous avez besoin des privilèges d’administrateur pour installer les modules dans PowerShell.

1. Installez et importez le module Az.

   Install-Module Az -AllowClobber
   Import-Module Az
   

2. Installez et importez le module Az.Peering.

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

3. Vérifiez que les modules ont été importés correctement à l’aide de cette commande :

   Get-Module
   

4. Connectez-vous à votre compte Azure à l’aide de cette commande :

   Connect-AzAccount
   

5. Vérifiez les abonnements pour le compte et sélectionnez l’abonnement dans lequel vous souhaitez créer un Peering.

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

6. Si vous n’avez pas déjà un groupe de ressources, vous devez en créer un avant de créer un peering. Pour cela, vous pouvez exécuter la commande suivante :

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

Important

Si vous n’avez pas encore associé votre ASN et votre abonnement, suivez les étapes de la procédure Associer le numéro ASN de l’homologue. Cette action est requise pour demander un Peering.

Remarque

L’emplacement d’un groupe de ressources est indépendant de l’emplacement où vous choisissez de configurer un Peering.  

Obtenir la liste des emplacements de Peering compatibles avec le Peering direct

La cmdlet PowerShell Get-AzPeeringLocation retourne une liste d’emplacements de Peering avec le paramètre obligatoire Kind, que vous utiliserez dans des étapes ultérieures.

Get-AzPeeringLocation -Kind Direct

Les emplacements de Peering direct contiennent les champs suivants :

• PeeringLocation
• Pays ou région
• PeeringDBFacilityId
• PeeringDBFacilityLink
• BandwidthOffers

Vérifiez que vous vous trouvez à l’installation de Peering souhaitée en vous reportant à PeeringDB.

Cet exemple montre comment utiliser Seattle comme emplacement de Peering pour créer un Peering direct.

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

Créer un Peering direct

L’exemple suivant montre comment créer un Peering direct 10 Gbits/s à Seattle.

Utilisez la cmdlet PowerShell New-AzPeeringDirectConnectionObject pour créer des objets DirectConnection à utiliser dans la nouvelle demande de Peering.

Cet exemple montre comment créer un objet 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

Remarque

Dans l’exemple précédent, la valeur de $peeringLocation[] doit correspondre à l’emplacement de Peering de votre choix.

Créez une autre connexion au cas où vous auriez besoin d’une redondance à un emplacement du Peering donné.

$connection2 = New-AzPeeringDirectConnectionObject `
    -PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
    -SessionPrefixV4 10.21.33.0/31 `
    -SessionPrefixV6 fe01::3f:0/127 `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

Utilisez la cmdlet PowerShell New-AzPeering pour créer un Peering direct. Cette commande requiert un ID de ressource ASN, qui peut être récupéré comme indiqué ici.

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

 

Voici un exemple de réponse lorsque la requête a bien été traitée.

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

Notez que, à la place de {subscriptionId} dans cette sortie, l’ID d’abonnement réel sera affiché.

Vérifier un Peering direct

Pour afficher la liste des Peerings, exécutez la commande Get-AzPeering.

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

L’exemple suivant illustre la réponse lorsque l’approvisionnement de bout en bout a bien été effectué.

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

Modifier un Peering direct

Cette section décrit comment effectuer les opérations de modification suivantes pour le peering direct :

• Ajouter des connexions de Peering direct.
• Supprimer des connexions de Peering direct.
• Mettez à niveau ou rétrogradez la bande passante sur les connexions actives.
• Ajouter des sessions IPv4 ou IPv6 sur des connexions actives.
• Supprimer des sessions IPv4 ou IPv6 sur des connexions actives.

Ajouter les connexions de Peering direct

Cet exemple décrit comment ajouter des connexions au Peering direct existant.

$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

Supprimer les connexions de Peering direct

Pour le moment, PowerShell ne prend pas en charge la suppression d’une connexion. Pour plus d’informations, contactez l’équipe Peering Microsoft.

Mettre à niveau ou rétrograder la bande passante sur les connexions actives

Cet exemple décrit comment ajouter 10 Gbits/s à une connexion directe existante.

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

Ajouter des sessions IPv4 ou IPv6 sur des connexions actives

Cet exemple décrit comment ajouter une session IPv6 sur une connexion directe existante avec une seule session IPv4.

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

Supprimer des sessions IPv4 ou IPv6 sur des connexions actives

La suppression d’une session IPv4 ou IPv6 sur une connexion existante n’est actuellement pas prise en charge sur PowerShell. Pour plus d’informations, contactez l’équipe Peering Microsoft.

Déprovisionner un Peering direct

Actuellement, le déprovisionnement n’est pas pris en charge à l’aide du Portail Microsoft Azure ou de PowerShell. Pour déprovisionner, contactez l’équipe Peering Microsoft.

Ressources supplémentaires

Vous pouvez obtenir une description détaillée de tous les paramètres en exécutant la commande suivante :

Get-Help Get-AzPeering -detailed

Étapes suivantes

• Créez ou modifiez le nœud homologue Exchange à l'aide de PowerShell.
• Convertissez un nœud homologue Exchange hérité en une ressource Azure à l'aide de PowerShell.
• Questions fréquemment posées (FAQ) sur le Peering Internet.