Partager via

Convertir un peering direct hérité en ressource Azure à l’aide de PowerShell

  • Article

Cet article explique comment convertir un peering Direct hérité en ressource Azure avec les cmdlets PowerShell.

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

Avant de commencer

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 Screenshot
Ouvrez Cloud Shell dans votre navigateur. https://shell.azure.com/powershell
Sélectionnez le bouton Cloud Shell dans la barre d’outils située dans l’angle supérieur droit du Portail Azure. Cloud Shell in the portal

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.

Convertir un Peering direct hérité en ressource Azure

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.  

Récupération d’un peering Direct hérité pour la conversion

Cet exemple montre comment obtenir un peering Direct hérité à l’emplacement de peering Seattle.

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

Voici un exemple de réponse :

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

Conversion d’un peering Direct hérité

 

Important

Lors de la conversion d’un peering hérité en ressource Azure, les modifications ne sont pas prises en charge.  

Utilisez cette commande pour convertir un peering Direct hérité en ressource Azure :

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

Voici un exemple de réponse :

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

Ressources supplémentaires

Pour obtenir une description détaillée de tous les paramètres, exécutez cette commande :

Get-Help Get-AzPeering -detailed

Étapes suivantes