Add-AzureRmExpressRouteCircuitPeeringConfig

  • Référence
Module:
AzureRM.Network

Ajoute une configuration de peering à un circuit ExpressRoute.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié 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.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

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
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-LegacyMode

Mode hérité du peering

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Nom de la relation de peering à ajouter.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PeerAddressType

PeerAddressType

Type:String
Valeurs acceptées:IPv4, IPv6
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PeeringType

Les valeurs acceptables pour ce paramètre sont les suivantes : AzurePrivatePeering, AzurePublicPeeringet MicrosoftPeering

Type:String
Valeurs acceptées:AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RouteFilter

Il s’agit d’un objet RouteFilter existant.

Type:PSRouteFilter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

PSExpressRouteCircuit

Paramètres : ExpressRouteCircuit (ByValue)

String

PSRouteFilter

Boolean

Sorties

PSExpressRouteCircuit