Partager via

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

  • Article

Cet article explique comment convertir un Peering Exchange hérité en ressource Azure à l’aide de 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 Exchange 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.  

Obtenir le Peering Exchange hérité pour la conversion

Cet exemple montre comment obtenir un Peering Exchange hérité à l’emplacement de Peering Seattle :

$legacyPeering = Get-AzLegacyPeering -Kind Exchange -PeeringLocation "Seattle"
$legacyPeering

La réponse ressemble à ce qui suit :

    Kind                     : Exchange
    PeeringLocation          : Seattle
    PeerAsn                  : 65000
    Connection               : ------------------------
    PeerSessionIPv4Address   : 10.21.31.100
    MicrosoftIPv4Address     : 10.21.31.50
    SessionStateV4           : Established
    MaxPrefixesAdvertisedV4  : 20000
    PeerSessionIPv6Address   : fe01::3e:100
    MicrosoftIPv6Address     : fe01::3e:50
    SessionStateV6           : Established
    MaxPrefixesAdvertisedV6  : 2000
    ConnectionState          : Active

Convertir un Peering hérité

Vous pouvez utiliser cette commande pour convertir un Peering Exchange hérité en ressource Azure :

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

 

Important

Lorsque vous convertissez un Peering hérité en ressource Azure, les modifications ne sont pas prises en charge.  

Cet exemple illustre la réponse lorsque l’approvisionnement de bout en bout a bien été effectué :

    Name                     : SeattleExchangePeering
    Kind                     : Exchange
    Sku                      : Basic_Exchange_Free
    PeeringLocation          : Seattle
    PeerAsn                  : 65000
    Connection               : ------------------------
    PeerSessionIPv4Address   : 10.21.31.100
    MicrosoftIPv4Address     : 10.21.31.50
    SessionStateV4           : Established
    MaxPrefixesAdvertisedV4  : 20000
    PeerSessionIPv6Address   : fe01::3e:100
    MicrosoftIPv6Address     : fe01::3e:50
    SessionStateV6           : Established
    MaxPrefixesAdvertisedV6  : 2000
    ConnectionState          : Active

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