Udostępnij za pośrednictwem

Add-AzureRmExpressRouteCircuitPeeringConfig

  • Odwołanie
Moduł:
AzureRM.Network

Dodaje konfigurację komunikacji równorzędnej do obwodu usługi ExpressRoute.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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>]

Opis

Polecenie cmdlet Add-AzureRmExpressRouteCircuitPeeringConfig dodaje konfigurację komunikacji równorzędnej do obwodu usługi ExpressRoute. Obwody usługi ExpressRoute łączą sieć lokalną z chmurą firmy Microsoft przy użyciu dostawcy łączności zamiast publicznego Internetu. Pamiętaj, że po uruchomieniu polecenia cmdlet Add-AzureRmExpressRouteCircuitPeeringConfig należy wywołać polecenie cmdlet Set-AzureRmExpressRouteCircuit, aby aktywować konfigurację.

Przykłady

Przykład 1. Dodawanie elementu równorzędnego do istniejącego obwodu usługi ExpressRoute

$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

Parametry

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ExpressRouteCircuit

Zmodyfikowany obwód usługi ExpressRoute. Jest to obiekt platformy Azure zwracany przez polecenie cmdlet Get-AzureRmExpressRouteCircuit .

Typ:PSExpressRouteCircuit
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-LegacyMode

Starszy tryb komunikacji równorzędnej

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-MicrosoftConfigAdvertisedPublicPrefixes

W przypadku elementu PeeringType usługi MicrosoftPeering należy podać listę wszystkich prefiksów, które mają być anonsowane w sesji protokołu BGP. Akceptowane są tylko prefiksy publicznych adresów IP. Jeśli zamierzasz wysłać zestaw prefiksów, możesz wysłać listę oddzielaną przecinkami. Te prefiksy muszą być zarejestrowane w nazwie rejestru routingu (RIR / IRR).

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MicrosoftConfigCustomerAsn

Jeśli reklamujesz prefiksy, które nie są zarejestrowane w numerze as komunikacji równorzędnej, możesz określić numer AS, do którego są zarejestrowane.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MicrosoftConfigRoutingRegistryName

Nazwa rejestru routingu (RIR/IRR), do której zarejestrowano numer AS i prefiksy.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Nazwa relacji komunikacji równorzędnej, która ma zostać dodana.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PeerAddressType

PeerAddressType

Typ:String
Dopuszczalne wartości:IPv4, IPv6
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PeerASN

Numer AS obwodu usługi ExpressRoute. Musi to być publiczny numer ASN, gdy element PeeringType to AzurePublicPeering.

Typ:UInt32
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PeeringType

Dopuszczalne wartości tego parametru to: AzurePrivatePeering, AzurePublicPeeringi MicrosoftPeering

Typ:String
Dopuszczalne wartości:AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PrimaryPeerAddressPrefix

Jest to zakres adresów IP dla podstawowej ścieżki routingu tej relacji komunikacji równorzędnej. Musi to być podsieć CIDR /30. Pierwszy adres z numerem nieparzystym w tej podsieci powinien zostać przypisany do interfejsu routera. Platforma Azure skonfiguruje następny adres numerowany parzystowo do interfejsu routera platformy Azure.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RouteFilter

Jest to istniejący obiekt RouteFilter.

Typ:PSRouteFilter
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RouteFilterId

Jest to identyfikator zasobu istniejącego obiektu RouteFilter.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SecondaryPeerAddressPrefix

Jest to zakres adresów IP dla pomocniczej ścieżki routingu tej relacji komunikacji równorzędnej. Musi to być podsieć CIDR /30. Pierwszy adres z numerem nieparzystym w tej podsieci powinien zostać przypisany do interfejsu routera. Platforma Azure skonfiguruje następny adres numerowany parzystowo do interfejsu routera platformy Azure.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SharedKey

Jest to opcjonalny skrót MD5 używany jako klucz wstępny dla konfiguracji komunikacji równorzędnej.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VlanId

Jest to identyfikator sieci VLAN przypisanej do tej komunikacji równorzędnej.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSExpressRouteCircuit

Parametry: ExpressRouteCircuit (ByValue)

String

PSRouteFilter

Boolean

Dane wyjściowe

PSExpressRouteCircuit