Réinitialiser des peerings de circuit ExpressRoute à l’aide d’Azure PowerShell

Article
12/28/2023

Cet article décrit comment activer et désactiver les Peerings d’un circuit ExpressRoute à l’aide de PowerShell. Les Peerings sont activés par défaut lorsque vous les créez. Lorsque vous désactivez un peering, la session BGP sur les connexions principale et secondaire de votre circuit ExpressRoute se déconnecte. Vous perdez la connectivité pour ce peering à Microsoft. Lorsque vous activez un peering, la session BGP sur les connexions principale et secondaire de votre circuit ExpressRoute est établie. La connectivité à Microsoft est rétablie pour ce peering. Vous pouvez activer et désactiver le Peering pour le Peering Microsoft et le Peering privé Azure indépendamment sur le circuit ExpressRoute.

Il existe deux scénarios dans lesquels il peut s’avérer utile de réinitialiser vos peerings ExpressRoute.

Si vous souhaitez tester la conception et l’implémentation de la récupération d’urgence. Par exemple, vous avez deux circuits ExpressRoute. Vous pouvez désactiver les Peerings sur un circuit et forcer votre trafic à basculer sur l’autre circuit.
Activez la détection de transfert bidirectionnel (BFD) sur le Peering privé Azure ou le Peering Microsoft de votre circuit ExpressRoute. La BFD est activée par défaut sur le Peering privé Azure si vous avez créé votre circuit ExpressRoute après le 1er août 2018, et après le 10 janvier 2020 pour le Peering Microsoft. Si votre circuit a été créé avant la date indiquée, vous devez réinitialiser le peering pour activer la BFD.

Utilisation d’Azure PowerShell

Les étapes et les exemples de cet article utilisent les modules Azure PowerShell Az. Pour installer les modules Az en local sur un ordinateur, voir Installer Azure PowerShell. Pour plus d’informations sur le module Az, voir Présentation du nouveau module Azure PowerShell Az. Les cmdlets PowerShell sont fréquemment mises à jour. Si vous n’exécutez pas leur dernière version, les valeurs spécifiées dans les instructions peuvent échouer. Pour rechercher les versions de PowerShell installées sur votre système, utilisez la cmdlet Get-Module -ListAvailable Az.

Il est possible d’utiliser Azure Cloud Shell pour exécuter la plupart des cmdlets PowerShell et des commandes CLI au lieu d’installer Azure PowerShell ou CLI en local. Azure Cloud Shell est un interpréteur de commandes interactif gratuit qui est configuré pour pouvoir être utilisé avec votre compte et dans lequel les outils Azure communs ont été préinstallés. Pour exécuter le code contenu dans cet article sur Azure Cloud Shell, ouvrez une session Cloud Shell, utilisez le bouton Copier sur un bloc de code pour copier le code, et collez-le dans la session Cloud Shell avec Ctrl+Maj+V sur Windows et Linux, ou avec Cmd+Maj+V sur macOS. Le texte collé ne s’exécute pas automatiquement ; appuyez sur Entrée pour exécuter le code.

Cloud Shell peut être lancé de plusieurs façons :

Option	Lien
Cliquez sur Essayer dans le coin supérieur droit d’un bloc de code.
Ouvrez Cloud Shell dans votre navigateur.
Cliquez sur le bouton Cloud Shell du menu situé dans l’angle supérieur droit de la fenêtre du portail Azure.

Réinitialiser un peering

Si vous exécutez PowerShell localement, ouvrez votre console PowerShell avec des privilèges élevés et connectez-vous à votre compte. Utilisez l’exemple suivant pour faciliter votre connexion :
```
Connect-AzAccount
```
Si vous disposez de plusieurs abonnements Azure, vérifiez les abonnements associés au compte.
```
Get-AzSubscription
```

Spécifiez l’abonnement à utiliser.

Select-AzSubscription -SubscriptionName "Replace_with_your_subscription_name"

Exécutez les commandes suivantes pour récupérer votre circuit ExpressRoute.

$ckt = Get-AzExpressRouteCircuit -Name "ExpressRouteARMCircuit" -ResourceGroupName "ExpressRouteResourceGroup"

Identifiez le peering que vous souhaitez activer ou désactiver. Peerings est un tableau. Dans l’exemple suivant, Peerings[0] est un peering privé Azure et Peerings[1] un peering Microsoft.

Name                             : ExpressRouteARMCircuit
ResourceGroupName                : ExpressRouteResourceGroup
Location                         : westus
Id                               : /subscriptions/########-####-####-####-############/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit
Etag                             : W/"cd011bef-dc79-49eb-b4c6-81fb6ea5d178"
ProvisioningState                : Succeeded
Sku                              : {
                                  "Name": "Standard_MeteredData",
                                  "Tier": "Standard",
                                  "Family": "MeteredData"
                                }
CircuitProvisioningState         : Enabled
ServiceProviderProvisioningState : Provisioned
ServiceProviderNotes             :
ServiceProviderProperties        : {
                                  "ServiceProviderName": "Coresite",
                                  "PeeringLocation": "Los Angeles",
                                  "BandwidthInMbps": 50
                                }
ServiceKey                       : ########-####-####-####-############
Peerings                         : [
                                  {
                                    "Name": "AzurePrivatePeering",
                                    "Etag": "W/\"cd011bef-dc79-49eb-b4c6-81fb6ea5d178\"",
                                    "Id": "/subscriptions/########-####-####-####-############/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit/peerings/AzurePrivatePeering",
                                    "PeeringType": "AzurePrivatePeering",
                                    "State": "Enabled",
                                    "AzureASN": 12076,
                                    "PeerASN": 123,
                                    "PrimaryPeerAddressPrefix": "10.0.0.0/30",
                                    "SecondaryPeerAddressPrefix": "10.0.0.4/30",
                                    "PrimaryAzurePort": "",
                                    "SecondaryAzurePort": "",
                                    "VlanId": 789,
                                    "MicrosoftPeeringConfig": {
                                      "AdvertisedPublicPrefixes": [],
                                      "AdvertisedCommunities": [],
                                      "AdvertisedPublicPrefixesState": "NotConfigured",
                                      "CustomerASN": 0,
                                      "LegacyMode": 0,
                                      "RoutingRegistryName": "NONE"
                                    },
                                    "ProvisioningState": "Succeeded",
                                    "GatewayManagerEtag": "",
                                    "LastModifiedBy": "Customer",
                                    "Connections": []
                                  },
                                  {
                                    "Name": "MicrosoftPeering",
                                    "Etag": "W/\"cd011bef-dc79-49eb-b4c6-81fb6ea5d178\"",
                                    "Id": "/subscriptions/########-####-####-####-############/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/ExpressRouteARMCircuit/peerings/MicrosoftPeering",
                                    "PeeringType": "MicrosoftPeering",
                                    "State": "Enabled",
                                    "AzureASN": 12076,
                                    "PeerASN": 123,
                                    "PrimaryPeerAddressPrefix": "3.0.0.0/30",
                                    "SecondaryPeerAddressPrefix": "3.0.0.4/30",
                                    "PrimaryAzurePort": "",
                                    "SecondaryAzurePort": "",
                                    "VlanId": 345,
                                    "MicrosoftPeeringConfig": {
                                      "AdvertisedPublicPrefixes": [
                                        "3.0.0.3/32"
                                      ],
                                      "AdvertisedCommunities": [],
                                      "AdvertisedPublicPrefixesState": "ValidationNeeded",
                                      "CustomerASN": 0,
                                      "LegacyMode": 0,
                                      "RoutingRegistryName": "NONE"
                                    },
                                    "ProvisioningState": "Succeeded",
                                    "GatewayManagerEtag": "",
                                    "LastModifiedBy": "Customer",
                                    "Connections": []
                                  }
                                ]
Authorizations                   : []
AllowClassicOperations           : False
GatewayManagerEtag               :

Exécutez les commandes suivantes pour modifier l’état du peering à désactivé.
```
$ckt.Peerings[0].State = "Disabled"
Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
```
Le peering doit être dans un état désactivé que vous définissez.
Exécutez les commandes suivantes pour modifier l’état du peering à nouveau sur activé.
```
$ckt.Peerings[0].State = "Enabled"
Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
```
Le peering doit être dans un état activé que vous définissez.

Étapes suivantes

Si vous avez besoin d’aide pour résoudre un problème avec ExpressRoute, consultez les articles suivants :

Réinitialiser des peerings de circuit ExpressRoute à l’aide d’Azure PowerShell

Utilisation d’Azure PowerShell

Réinitialiser un peering

Étapes suivantes

Ressources supplémentaires