Compartir a través de

Add-AzureRmExpressRouteCircuitPeeringConfig

  • Referencia
Módulo:
AzureRM.Network

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

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

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

El cmdlet Add-AzureRmExpressRouteCircuitPeeringConfig 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-AzureRmExpressRouteCircuitPeeringConfig, debe llamar al cmdlet Set-AzureRmExpressRouteCircuit para activar la configuración.

Ejemplos

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

$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

Parámetros

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExpressRouteCircuit

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

Tipo:PSExpressRouteCircuit
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-LegacyMode

Modo heredado del emparejamiento

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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).

Tipo:List<T>[String]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MicrosoftConfigRoutingRegistryName

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PeerAddressType

PeerAddressType

Tipo:String
Valores aceptados:IPv4, IPv6
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PeerASN

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

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PeeringType

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

Tipo:String
Valores aceptados:AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RouteFilter

Se trata de un objeto RouteFilter existente.

Tipo:PSRouteFilter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-RouteFilterId

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SharedKey

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VlanId

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

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

PSExpressRouteCircuit

Parámetros: ExpressRouteCircuit (ByValue)

String

PSRouteFilter

Boolean

Salidas

PSExpressRouteCircuit