Créer ou modifier un Peering Exchange à l’aide de PowerShell
Cet article explique comment créer un Peering Exchange Microsoft à l’aide d’applets de commande PowerShell et du modèle de déploiement 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 Exchange avant de commencer la configuration.
- Si vous avez déjà des Peerings Exchange avec Microsoft qui ne sont pas convertis en ressources Azure, consultez Convertir un Peering Exchange 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 provisionner un Peering Exchange
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.
Installez et importez le module Az.
Install-Module Az -AllowClobber Import-Module AzInstallez et importez le module Az.Peering.
Install-Module -Name Az.Peering -AllowClobber Import-Module Az.PeeringVérifiez que les modules ont été importés correctement à l’aide de cette commande :
Get-ModuleConnectez-vous à votre compte Azure à l’aide de cette commande :
Connect-AzAccountVé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"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 Exchange
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 "Exchange"
Les emplacements de Peering Exchange contiennent les champs suivants :
- ExchangeName
- PeeringLocation
- Pays ou région
- PeeringDBFacilityId
- PeeringDBFacilityLink
- MicrosoftIPv4Address
- MicrosoftIPv6Address
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.
$exchangeLocations = Get-AzPeeringLocation -Kind Exchange
$exchangeLocation = $exchangeLocations | where {$_.PeeringLocation -eq "Seattle"}
#check the location metadata
$exchangeLocation
ExchangeName : Columbia IX
PeeringLocation : Seattle
Country : US
PeeringDBFacilityId : 99999
PeeringDBFacilityLink : https://www.peeringdb.com/ix/99999
MicrosoftIPv4Address : 10.12.97.129
MicrosoftIPv6Address :
ExchangeName : Equinix Seattle
PeeringLocation : Seattle
Country : US
PeeringDBFacilityId : 11
PeeringDBFacilityLink : https://www.peeringdb.com/ix/11
MicrosoftIPv4Address : 198.32.134.152
MicrosoftIPv6Address : 2001:504:12::15
...
Créer un Peering Exchange
L’exemple suivant montre comment créer une connexion Exchange sur Equinix Internet Exchange à Seattle. Si vous utilisez un autre fournisseur et des paramètres différents, utilisez ces informations quand vous créez votre requête.
Utilisez la cmdlet PowerShell New-AzPeeringExchangeConnectionObject pour créer des objets de connexion PowerShell qui seront utilisés pour générer la nouvelle demande de Peering.
Cet exemple montre comment créer une connexion Exchange.
$connection1 = New-AzPeeringExchangeConnectionObject `
-PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
-PeerSessionIPv4Address 198.32.134.22 `
-PeerSessionIPv6Address 2001:504:12::22 `
-MaxPrefixesAdvertisedIPv4 2000 `
-MaxPrefixesAdvertisedIPv6 2000 `
Créez une autre connexion au cas où vous auriez besoin d’une redondance à l’emplacement du Peering donné.
$connection2 = New-AzPeeringExchangeConnectionObject `
-PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
-PeerSessionIPv4Address 198.32.134.23 `
-PeerSessionIPv6Address 2001:504:12::23 `
-MaxPrefixesAdvertisedIPv4 2000 `
-MaxPrefixesAdvertisedIPv6 2000 `
La cmdlet PowerShell New-AzPeering peut être utilisée pour créer un nouveau Peering Exchange.
$asn = Get-AzPeerAsn
New-AzPeering `
-Name "SeattleExchangePeering" `
-ResourceGroupName "PeeringResourceGroup" `
-PeerAsnResourceId $asn.Id `
-PeeringLocation $exchangeLocation[1].PeeringLocation `
-ExchangeConnection $connection1[, $connection2]
Voici un exemple de réponse lorsque la requête a été exécutée à l’aide d’une connexion.
Name : SeattleExchangePeering
Sku.Name : Basic_Exchange_Free
Kind : Exchange
Connections : {11}
PeerAsn.Id : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{peerAsnName}
PeeringLocation : Seattle
ProvisioningState : Succeeded
Location : West US 2
Id : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleExchangePeering
Type : Microsoft.Peering/peerings
Tags : {}
Important
Microsoft commence à approvisionner le Peering demandé et ConnectionState reflète la progression.
Pour plus d’informations sur les étapes liées à l’approvisionnement, consultez la procédure pas à pas du Peering Exchange.
Vous pouvez vérifier l’état de la connexion, comme indiqué ici.
$peering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
$peering.Connections
PeeringDBFacilityId : 11
PeerSessionIPv4Address : 198.32.134.22
PeerSessionIPv6Address : 2001:504:12::22
SessionStateV4 : PendingAdd
SessionStateV6 : PendingAdd
MaxPrefixesAdvertisedV4 : 2000
MaxPrefixesAdvertisedV6 : 2000
MicrosoftSessionIPv4Address : 198.32.134.152
MicrosoftSessionIPv4Address : 2001:504:12::15
Md5AuthenticationKey :
Obtenir un Peering Exchange
Pour afficher la liste des Peerings, exécutez la commande Get-AzPeering.
Get-AzPeering ResourceGroupName "PeeringResourceGroup" -Name "SeattleExchangePeering"
Cet exemple illustre la réponse lorsque l’approvisionnement de bout en bout a bien été effectué.
Name : SeattleExchangePeering
Sku : Basic_Exchange_Free
Kind : Exchange
PeeringLocation : Seattle
ProvisioningState : Succeeded
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
Connection : ------------------------
PeerSessionIPv4Address : 10.21.31.101
MicrosoftIPv4Address : 10.21.31.51
SessionStateV4 : Established
MaxPrefixesAdvertisedV4 : 20000
PeerSessionIPv6Address : fe01::3e:101
MicrosoftIPv6Address : fe01::3e:51
SessionStateV6 : Established
MaxPrefixesAdvertisedV6 : 2000
ConnectionState : Active
Modifier un Peering Exchange
Les opérations de modification suivantes sont prises en charge pour le Peering Exchange :
- Ajouter des connexions de Peering Exchange.
- Supprimer des connexions de Peering Exchange.
- Ajouter une session IPv4 ou IPv6 sur des connexions actives.
- Supprimer une session IPv4 ou IPv6 sur des connexions actives.
Ajouter des connexions de peering Exchange
Cet exemple décrit comment ajouter des connexions à un Peering Exchange existant.
$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
$connection = New-AzPeeringExchangeConnectionObject `
-PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
-PeerSessionIPv4Address 198.32.134.22 `
-PeerSessionIPv6Address 2001:504:12::22 `
-MaxPrefixesAdvertisedIPv4 2000 `
-MaxPrefixesAdvertisedIPv6 2000 `
$exchangePeering.Connections.Add($connection)
$exchangePeering | Update-AzPeering
Supprimer des connexions de peering Exchange
Cet exemple décrit comment supprimer des connexions sur un Peering Exchange existant.
$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
Affichez toutes les connexions, puis sélectionnez la connexion que vous souhaitez supprimer.
$exchangePeering
Name : SeattleExchangePeering
Sku.Name : Basic_Exchange_Free
Kind : Exchange
Connections : {11}
PeerAsn.Id : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{peerAsnName}
PeeringLocation : Seattle
ProvisioningState : Succeeded
Location : West US 2
Id : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleExchangePeering
Type : Microsoft.Peering/peerings
Tags : {}
Dans la commande suivante, au lieu de 0, entrez le numéro d’index de la connexion que vous souhaitez supprimer.
$connection = $exchangePeering.Connections[0]
$exchangePeering.Connections.Remove($connection)
$exchangePeering | Update-AzPeering
Ajouter une session IPv4 ou IPv6 sur des connexions actives
Cet exemple décrit comment ajouter une session IPv6 à une connexion Exchange existante.
$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
$exchangePeering.Connections[0].BgpSession.PeerSessionIPv6Address = "2001:504:12::34"
$exchangePeering | Update-AzPeering
Supprimer une session 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 Exchange
Pour le moment, ni le portail Azure ni PowerShell ne prennent en charge le désapprovisionnement. 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