Add-AzExpressRouteCircuitPeeringConfig

  • Referenz
Modul:
Az.Network

Fügt eine Peeringkonfiguration zu einem ExpressRoute-Schaltkreis hinzu.

Syntax

Add-AzExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -PeeringType <String>
   -PeerASN <UInt32>
   -PrimaryPeerAddressPrefix <String>
   -SecondaryPeerAddressPrefix <String>
   -VlanId <Int32>
   [-SharedKey <String>]
   [-MicrosoftConfigAdvertisedPublicPrefixes <String[]>]
   [-MicrosoftConfigCustomerAsn <Int32>]
   [-MicrosoftConfigRoutingRegistryName <String>]
   [-PeerAddressType <String>]
   [-LegacyMode <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -PeeringType <String>
   -PeerASN <UInt32>
   -PrimaryPeerAddressPrefix <String>
   -SecondaryPeerAddressPrefix <String>
   -VlanId <Int32>
   [-SharedKey <String>]
   [-MicrosoftConfigAdvertisedPublicPrefixes <String[]>]
   [-MicrosoftConfigCustomerAsn <Int32>]
   [-MicrosoftConfigRoutingRegistryName <String>]
   -RouteFilterId <String>
   [-PeerAddressType <String>]
   [-LegacyMode <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzExpressRouteCircuitPeeringConfig
   -Name <String>
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   -PeeringType <String>
   -PeerASN <UInt32>
   -PrimaryPeerAddressPrefix <String>
   -SecondaryPeerAddressPrefix <String>
   -VlanId <Int32>
   [-SharedKey <String>]
   [-MicrosoftConfigAdvertisedPublicPrefixes <String[]>]
   [-MicrosoftConfigCustomerAsn <Int32>]
   [-MicrosoftConfigRoutingRegistryName <String>]
   -RouteFilter <PSRouteFilter>
   [-PeerAddressType <String>]
   [-LegacyMode <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Add-AzExpressRouteCircuitPeeringConfig-Cmdlet fügt einer ExpressRoute-Verbindung eine Peeringkonfiguration hinzu. ExpressRoute-Schaltkreise verbinden Ihr lokales Netzwerk mit der Microsoft-Cloud, indem sie einen Konnektivitätsanbieter anstelle des öffentlichen Internets verwenden. Beachten Sie, dass Sie nach dem Ausführen von Add-AzExpressRouteCircuitPeeringConfig das Cmdlet Set-AzExpressRouteCircuit aufrufen müssen, um die Konfiguration zu aktivieren.

Beispiele

Beispiel 1: Hinzufügen eines Peers zu einem vorhandenen ExpressRoute-Schaltkreis

$circuit = Get-AzExpressRouteCircuit -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-AzExpressRouteCircuitPeeringConfig @parameters
Set-AzExpressRouteCircuit -ExpressRouteCircuit $circuit

Beispiel 2

Fügt eine Peeringkonfiguration zu einem ExpressRoute-Schaltkreis hinzu. (automatisch generiert)

Add-AzExpressRouteCircuitPeeringConfig -ExpressRouteCircuit <PSExpressRouteCircuit> -MicrosoftConfigAdvertisedPublicPrefixes <String[]> -MicrosoftConfigCustomerAsn <Int32> -MicrosoftConfigRoutingRegistryName <String> -Name 'AzurePrivatePeering' -PeerASN 100 -PeerAddressType IPv4 -PeeringType AzurePrivatePeering -PrimaryPeerAddressPrefix '123.0.0.0/30' -SecondaryPeerAddressPrefix '123.0.0.4/30' -VlanId 300

Parameter

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExpressRouteCircuit

Der expressRoute-Schaltkreis, der geändert wird. Dies ist ein Azure-Objekt, das vom Cmdlet Get-AzExpressRouteCircuit zurückgegeben wird.

Typ:PSExpressRouteCircuit
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-LegacyMode

Der Legacymodus des Peerings

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-MicrosoftConfigAdvertisedPublicPrefixes

Für einen PeeringType von MicrosoftPeering müssen Sie eine Liste aller Präfixe angeben, die Sie über die BGP-Sitzung bewerben möchten. Nur öffentliche IP-Adresspräfixe werden akzeptiert. Sie können eine kommagetrennte Liste senden, wenn Sie planen, einen Satz mit Präfixen zu senden. Diese Präfixe müssen bei Ihnen in einem RoutingRegistrierungsnamen (ROUTING Registry Name, RIR / IRR) registriert werden.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MicrosoftConfigCustomerAsn

Wenn Sie Präfixe ankündigen, die nicht für die Peering-AS-Nummer registriert sind, können Sie die AS-Nummer angeben, unter der sie registriert sind.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MicrosoftConfigRoutingRegistryName

Der Routingregistrierungsname (RIR/ IRR), in den die AS-Nummer und präfixe registriert sind.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Der Name der hinzuzufügenden Peeringbeziehung.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PeerAddressType

PeerAddressType

Typ:String
Zulässige Werte:IPv4, IPv6
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PeerASN

Die AS-Nummer Ihres ExpressRoute-Schaltkreises. Dies muss ein öffentliches ASN sein, wenn der PeeringType AzurePublicPeering ist.

Typ:UInt32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PeeringType

Die zulässigen Werte für diesen Parameter sind: AzurePrivatePeering, , AzurePublicPeeringund MicrosoftPeering

Typ:String
Zulässige Werte:AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PrimaryPeerAddressPrefix

Dies ist der IP-Adressbereich für den primären Routingpfad dieser Peeringbeziehung. Dies muss ein /30 CIDR-Subnetz sein. Die erste ungerade Nummer in diesem Subnetz sollte Ihrer Routerschnittstelle zugewiesen werden. Azure konfiguriert die nächste gerade Nummerierte Adresse auf der Azure-Routerschnittstelle.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RouteFilter

Dies ist ein vorhandenes RouteFilter-Objekt.

Typ:PSRouteFilter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RouteFilterId

Dies ist die Ressourcen-ID eines vorhandenen RouteFilter-Objekts.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SecondaryPeerAddressPrefix

Dies ist der IP-Adressbereich für den sekundären Routingpfad dieser Peeringbeziehung. Dies muss ein /30 CIDR-Subnetz sein. Die erste ungerade Nummer in diesem Subnetz sollte Ihrer Routerschnittstelle zugewiesen werden. Azure konfiguriert die nächste gerade Nummerierte Adresse auf der Azure-Routerschnittstelle.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SharedKey

Dies ist ein optionaler MD5-Hash, der als vorab freigegebener Schlüssel für die Peeringkonfiguration verwendet wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VlanId

Dies ist die ID-Nummer des VLANs, das diesem Peering zugewiesen wurde.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSExpressRouteCircuit

String

PSRouteFilter

Boolean

Ausgaben

PSExpressRouteCircuit