Add-AzureRmExpressRouteCircuitPeeringConfig
Ajoute une configuration de peering à un circuit ExpressRoute.
Avertissement
Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.
Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.
Syntax
Add-AzureRmExpressRouteCircuitPeeringConfig
-Name <String>
-ExpressRouteCircuit <PSExpressRouteCircuit>
-PeeringType <String>
-PeerASN <UInt32>
-PrimaryPeerAddressPrefix <String>
-SecondaryPeerAddressPrefix <String>
-VlanId <Int32>
[-SharedKey <String>]
[-MicrosoftConfigAdvertisedPublicPrefixes <System.Collections.Generic.List`1[System.String]>]
[-MicrosoftConfigCustomerAsn <Int32>]
[-MicrosoftConfigRoutingRegistryName <String>]
[-PeerAddressType <String>]
[-LegacyMode <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Add-AzureRmExpressRouteCircuitPeeringConfig
-Name <String>
-ExpressRouteCircuit <PSExpressRouteCircuit>
-PeeringType <String>
-PeerASN <UInt32>
-PrimaryPeerAddressPrefix <String>
-SecondaryPeerAddressPrefix <String>
-VlanId <Int32>
[-SharedKey <String>]
[-MicrosoftConfigAdvertisedPublicPrefixes <System.Collections.Generic.List`1[System.String]>]
[-MicrosoftConfigCustomerAsn <Int32>]
[-MicrosoftConfigRoutingRegistryName <String>]
-RouteFilterId <String>
[-PeerAddressType <String>]
[-LegacyMode <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Add-AzureRmExpressRouteCircuitPeeringConfig
-Name <String>
-ExpressRouteCircuit <PSExpressRouteCircuit>
-PeeringType <String>
-PeerASN <UInt32>
-PrimaryPeerAddressPrefix <String>
-SecondaryPeerAddressPrefix <String>
-VlanId <Int32>
[-SharedKey <String>]
[-MicrosoftConfigAdvertisedPublicPrefixes <System.Collections.Generic.List`1[System.String]>]
[-MicrosoftConfigCustomerAsn <Int32>]
[-MicrosoftConfigRoutingRegistryName <String>]
-RouteFilter <PSRouteFilter>
[-PeerAddressType <String>]
[-LegacyMode <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
L’applet de commande Add-AzureRmExpressRouteCircuitPeeringConfig ajoute une configuration de peering à un circuit ExpressRoute. Les circuits ExpressRoute connectent votre réseau local au cloud Microsoft à l’aide d’un fournisseur de connectivité au lieu d’Internet public. Notez que, après avoir exécuté Add-AzureRmExpressRouteCircuitPeeringConfig, vous devez appeler l’applet de commande Set-AzureRmExpressRouteCircuit pour activer la configuration.
Exemples
Exemple 1 : Ajouter un homologue à un circuit ExpressRoute existant
$circuit = Get-AzureRmExpressRouteCircuit -Name $CircuitName -ResourceGroupName $rg
$parameters = @{
Name = 'AzurePrivatePeering'
Circuit = $circuit
PeeringType = 'AzurePrivatePeering'
PeerASN = 100
PrimaryPeerAddressPrefix = '10.6.1.0/30'
SecondaryPeerAddressPrefix = '10.6.2.0/30'
VlanId = 200
}
Add-AzureRmExpressRouteCircuitPeeringConfig @parameters
Set-AzureRmExpressRouteCircuit -ExpressRouteCircuit $circuit
Paramètres
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExpressRouteCircuit
Circuit ExpressRoute en cours de modification. Il s’agit d’un objet Azure retourné par l’applet de commande Get-AzureRmExpressRouteCircuit .
Type: | PSExpressRouteCircuit |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LegacyMode
Mode hérité du peering
Type: | Boolean |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MicrosoftConfigAdvertisedPublicPrefixes
Pour un PeeringType de MicrosoftPeering, vous devez fournir la liste de tous les préfixes que vous prévoyez de publier sur la session BGP. Seuls les préfixes d'adresses IP publiques sont acceptés. Vous pouvez envoyer une liste séparée par des virgules si vous prévoyez d'envoyer un jeu de préfixes. Ces préfixes doivent être inscrits auprès de vous dans un nom de registre de routage (RIR /IRR).
Type: | List<T>[String] |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MicrosoftConfigCustomerAsn
si vous publiez des préfixes non enregistrés dans le numéro AS de peering, vous pouvez spécifier le numéro AS avec lequel ils sont enregistrés.
Type: | Int32 |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MicrosoftConfigRoutingRegistryName
Nom du registre de routage (RIR /IRR) auquel le numéro AS et les préfixes sont inscrits.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Nom de la relation de peering à ajouter.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PeerAddressType
PeerAddressType
Type: | String |
valeurs acceptées: | IPv4, IPv6 |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PeerASN
Numéro AS de votre circuit ExpressRoute. Il doit s’agir d’un ASN public lorsque PeeringType est AzurePublicPeering.
Type: | UInt32 |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PeeringType
Les valeurs acceptables pour ce paramètre sont les suivantes : AzurePrivatePeering
, AzurePublicPeering
et MicrosoftPeering
Type: | String |
valeurs acceptées: | AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrimaryPeerAddressPrefix
Il s’agit de la plage d’adresses IP pour le chemin d’accès de routage principal de cette relation de peering. Il doit s’agir d’un sous-réseau CIDR /30. La première adresse impaire de ce sous-réseau doit être affectée à votre interface de routeur. Azure configure l’adresse pair suivante à l’interface du routeur Azure.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RouteFilter
Il s’agit d’un objet RouteFilter existant.
Type: | PSRouteFilter |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RouteFilterId
Il s’agit de l’ID de ressource d’un objet RouteFilter existant.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SecondaryPeerAddressPrefix
Il s’agit de la plage d’adresses IP pour le chemin d’accès de routage secondaire de cette relation de peering. Il doit s’agir d’un sous-réseau CIDR /30. La première adresse impaire de ce sous-réseau doit être affectée à votre interface de routeur. Azure configure l’adresse pair suivante à l’interface du routeur Azure.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SharedKey
Il s’agit d’un hachage MD5 facultatif utilisé comme clé prédéfinie pour la configuration du peering.
Type: | String |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VlanId
Il s’agit du numéro d’ID du réseau local virtuel affecté pour ce peering.
Type: | Int32 |
Position: | Named |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Paramètres : ExpressRouteCircuit (ByValue)