Udostępnij za pośrednictwem

New-AzureRmExpressRouteCircuitPeeringConfig

  • Odwołanie
Moduł:
AzureRM.Network

Tworzy nową konfigurację komunikacji równorzędnej, która ma zostać dodana do obwodu usługi ExpressRoute.

Ostrzeżenie

Moduł AzureRM PowerShell został 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

New-AzureRmExpressRouteCircuitPeeringConfig
   -Name <String>
   -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>]
New-AzureRmExpressRouteCircuitPeeringConfig
   -Name <String>
   -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>]
New-AzureRmExpressRouteCircuitPeeringConfig
   -Name <String>
   -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 New-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.

Przykłady

Przykład 1. Tworzenie nowego obwodu usługi ExpressRoute z konfiguracją komunikacji równorzędnej

$parameters = @{
    Name = 'AzurePrivatePeering'
    Circuit = $circuit
    PeeringType = 'AzurePrivatePeering'
    PeerASN = 100
    PrimaryPeerAddressPrefix = '10.6.1.0/30'
    SecondaryPeerAddressPrefix = '10.6.2.0/30'
    VlanId  = 200
}
$PeerConfig = New-AzureRmExpressRouteCircuitPeeringConfig @parameters

$parameters = @{
    Name='ExpressRouteCircuit'
    ResourceGroupName='ExpressRouteResourceGroup'
    Location='West US'
    SkuTier='Standard'
    SkuFamily='MeteredData'
    ServiceProviderName='Equinix'
    Peering=$PeerConfig
    PeeringLocation='Silicon Valley'
    BandwidthInMbps=200
}
New-AzureRmExpressRouteCircuit @parameters

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

-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 konfiguracji komunikacji równorzędnej, która ma zostać utworzona.

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

String

PSRouteFilter

Boolean

Dane wyjściowe

PSPeering