Add-AzExpressRouteCircuitPeeringConfig

Agrega una configuración de emparejamiento a un circuito ExpressRoute.

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

Description

El cmdlet Add-AzExpressRouteCircuitPeeringConfig agrega una configuración de emparejamiento a un circuito ExpressRoute. Los circuitos ExpressRoute conectan la red local a la nube de Microsoft mediante un proveedor de conectividad en lugar de la red pública de Internet. Tenga en cuenta que, después de ejecutar Add-AzExpressRouteCircuitPeeringConfig, debe llamar al cmdlet Set-AzExpressRouteCircuit para activar la configuración.

Ejemplos

Ejemplo 1: Agregar un elemento del mismo nivel a un circuito ExpressRoute existente

$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

Ejemplo 2

Agrega una configuración de emparejamiento a un circuito ExpressRoute. (generado automáticamente)

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

Parámetros

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpressRouteCircuit

Circuito ExpressRoute que se está modificando. Este es el objeto de Azure devuelto por el cmdlet Get-AzExpressRouteCircuit .

Type:PSExpressRouteCircuit
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-LegacyMode

Modo heredado del emparejamiento

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MicrosoftConfigAdvertisedPublicPrefixes

Para peeringType de MicrosoftPeering, debe proporcionar una lista de todos los prefijos que planea anunciar a través de la sesión BGP. Se aceptan solo prefijos de direcciones IP públicas. Puede enviar una lista separada por comas si tiene pensado enviar un conjunto de prefijos. Estos prefijos deben registrarse en un nombre del Registro de enrutamiento (RIR o IRR).

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MicrosoftConfigCustomerAsn

si anuncia prefijos que no están registrados en el número de AS de emparejamiento, puede especificar el número de AS en el que están registrados.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MicrosoftConfigRoutingRegistryName

Nombre del Registro de enrutamiento (RIR/IRR) al que se registran el número de AS y los prefijos.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Nombre de la relación de emparejamiento que se va a agregar.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PeerAddressType

PeerAddressType

Type:String
Accepted values:IPv4, IPv6
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PeerASN

Número as del circuito ExpressRoute. Debe ser un ASN público cuando PeeringType es AzurePublicPeering.

Type:UInt32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PeeringType

Los valores aceptables para este parámetro son: AzurePrivatePeering, AzurePublicPeeringy MicrosoftPeering

Type:String
Accepted values:AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PrimaryPeerAddressPrefix

Este es el intervalo de direcciones IP para la ruta de acceso de enrutamiento principal de esta relación de emparejamiento. Debe ser una subred CIDR /30. La primera dirección impar en esta subred debe asignarse a la interfaz del enrutador. Azure configurará la siguiente dirección uniforme en la interfaz del enrutador de Azure.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RouteFilter

Se trata de un objeto RouteFilter existente.

Type:PSRouteFilter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RouteFilterId

Este es el identificador de recurso de un objeto RouteFilter existente.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SecondaryPeerAddressPrefix

Este es el intervalo de direcciones IP para la ruta de enrutamiento secundaria de esta relación de emparejamiento. Debe ser una subred CIDR /30. La primera dirección impar en esta subred debe asignarse a la interfaz del enrutador. Azure configurará la siguiente dirección uniforme en la interfaz del enrutador de Azure.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SharedKey

Se trata de un hash MD5 opcional que se usa como clave precompartida para la configuración de emparejamiento.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VlanId

Este es el número de identificador de la VLAN asignada para este emparejamiento.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSExpressRouteCircuit

String

PSRouteFilter

Boolean

Salidas

PSExpressRouteCircuit