Dela via


Add-AzureRmExpressRouteCircuitPeeringConfig

Lägger till en peering-konfiguration till en ExpressRoute-krets.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

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

Cmdleten Add-AzureRmExpressRouteCircuitPeeringConfig lägger till en peeringkonfiguration till en ExpressRoute-krets. ExpressRoute-kretsar ansluter ditt lokala nätverk till Microsoft-molnet med hjälp av en anslutningsleverantör i stället för det offentliga Internet. Observera att när du har kört Add-AzureRmExpressRouteCircuitPeeringConfig måste du anropa cmdleten Set-AzureRmExpressRouteCircuit för att aktivera konfigurationen.

Exempel

Exempel 1: Lägga till en peer till en befintlig ExpressRoute-krets

$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

Parametrar

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpressRouteCircuit

ExpressRoute-kretsen ändras. Det här är Ett Azure-objekt som returneras av cmdleten Get-AzureRmExpressRouteCircuit .

Typ:PSExpressRouteCircuit
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-LegacyMode

Det äldre läget för peering

Typ:Boolean
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-MicrosoftConfigAdvertisedPublicPrefixes

För en PeeringType av MicrosoftPeering måste du ange en lista över alla prefix som du planerar att annonsera över BGP-sessionen. Endast offentliga IP-adressprefix accepteras. Du kan skicka en kommaavgränsad lista om du planerar att skicka en uppsättning prefix. Dessa prefix måste vara registrerade för dig i ett routningsregisternamn (RIR/IRR).

Typ:List<T>[String]
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-MicrosoftConfigCustomerAsn

Om du annonserar prefix som inte är registrerade i peering-AS-numret kan du ange det AS-nummer som de är registrerade för.

Typ:Int32
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-MicrosoftConfigRoutingRegistryName

Routningsregistrets namn (RIR/IRR) som AS-numret och prefixen är registrerade på.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Namnet på peering-relationen som ska läggas till.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

-PeerAddressType

PeerAddressType

Typ:String
accepterade värden:IPv4, IPv6
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-PeerASN

AS-numret för din ExpressRoute-krets. Detta måste vara ett offentligt ASN när PeeringType är AzurePublicPeering.

Typ:UInt32
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

-PeeringType

De godtagbara värdena för den här parametern är: AzurePrivatePeering, AzurePublicPeeringoch MicrosoftPeering

Typ:String
accepterade värden:AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

-PrimaryPeerAddressPrefix

Det här är IP-adressintervallet för den primära routningssökvägen för den här peeringrelationen. Detta måste vara ett /30 CIDR-undernät. Den första udda numrerade adressen i det här undernätet ska tilldelas till routergränssnittet. Azure konfigurerar nästa jämna adress till Azure-routergränssnittet.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

-RouteFilter

Det här är ett befintligt RouteFilter-objekt.

Typ:PSRouteFilter
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-RouteFilterId

Det här är resurs-ID:t för ett befintligt RouteFilter-objekt.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-SecondaryPeerAddressPrefix

Det här är IP-adressintervallet för den sekundära routningssökvägen för den här peeringrelationen. Detta måste vara ett /30 CIDR-undernät. Den första udda numrerade adressen i det här undernätet ska tilldelas till routergränssnittet. Azure konfigurerar nästa jämna adress till Azure-routergränssnittet.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

-SharedKey

Det här är en valfri MD5-hash som används som en i förväg delad nyckel för peeringkonfigurationen.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-VlanId

Det här är ID-numret för det VLAN som tilldelats för den här peeringen.

Typ:Int32
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

Indata

PSExpressRouteCircuit

Parametrar: ExpressRouteCircuit (ByValue)

String

PSRouteFilter

Boolean

Utdata

PSExpressRouteCircuit