Compartilhar via


Add-AzExpressRouteCircuitPeeringConfig

Adiciona uma configuração de emparelhamento a um circuito do ExpressRoute.

Sintaxe

SetByResource (Default)

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

MicrosoftPeeringConfigRoutFilterId

Add-AzExpressRouteCircuitPeeringConfig
    -Name <String>
    -ExpressRouteCircuit <PSExpressRouteCircuit>
    -PeeringType <String>
    -PeerASN <UInt32>
    -PrimaryPeerAddressPrefix <String>
    -SecondaryPeerAddressPrefix <String>
    -VlanId <Int32>
    -RouteFilterId <String>
    [-SharedKey <String>]
    [-MicrosoftConfigAdvertisedPublicPrefixes <String[]>]
    [-MicrosoftConfigCustomerAsn <Int32>]
    [-MicrosoftConfigRoutingRegistryName <String>]
    [-PeerAddressType <String>]
    [-LegacyMode <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

MicrosoftPeeringConfigRoutFilter

Add-AzExpressRouteCircuitPeeringConfig
    -Name <String>
    -ExpressRouteCircuit <PSExpressRouteCircuit>
    -PeeringType <String>
    -PeerASN <UInt32>
    -PrimaryPeerAddressPrefix <String>
    -SecondaryPeerAddressPrefix <String>
    -VlanId <Int32>
    -RouteFilter <PSRouteFilter>
    [-SharedKey <String>]
    [-MicrosoftConfigAdvertisedPublicPrefixes <String[]>]
    [-MicrosoftConfigCustomerAsn <Int32>]
    [-MicrosoftConfigRoutingRegistryName <String>]
    [-PeerAddressType <String>]
    [-LegacyMode <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

O cmdlet Add-AzExpressRouteCircuitPeeringConfig adiciona uma configuração de emparelhamento a um circuito do ExpressRoute. Os circuitos do ExpressRoute conectam sua rede local à nuvem Microsoft usando um provedor de conectividade em vez da Internet pública. Observe que, depois de executar Add-AzExpressRouteCircuitPeeringConfig, você deve chamar o cmdlet Set-AzExpressRouteCircuit para ativar a configuração.

Exemplos

Exemplo 1: Adicionar um par a um circuito existente do ExpressRoute

$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

Exemplo 2

Adiciona uma configuração de emparelhamento a um circuito do ExpressRoute. (autogenerated)

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

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ExpressRouteCircuit

O circuito do ExpressRoute que está sendo modificado. Este é Azure objeto retornado pelo cmdlet Get-AzExpressRouteCircuit.

Propriedades do parâmetro

Tipo:PSExpressRouteCircuit
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LegacyMode

O modo herdado do emparelhamento

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-MicrosoftConfigAdvertisedPublicPrefixes

Para um PeeringType do MicrosoftPeering, você deve fornecer uma lista de todos os prefixos que pretende anunciar na sessão BGP. Somente prefixos de endereços IP públicos são aceitos. Você pode enviar uma lista separada por vírgulas se planeja enviar um conjunto de prefixos. Esses prefixos devem ser registrados em um Nome do Registro de Roteamento (RIR/IRR).

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MicrosoftConfigCustomerAsn

Se você estiver anunciando prefixos que não estão registrados no número AS de emparelhamento, você poderá especificar o número AS ao qual eles estão registrados.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MicrosoftConfigRoutingRegistryName

O Nome do Registro de Roteamento (RIR/IRR) para o qual o número AS e os prefixos são registrados.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

O nome da relação de emparelhamento a ser adicionada.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PeerAddressType

PeerAddressType

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:IPv4, IPv6
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-PeerASN

O número AS do circuito do ExpressRoute. Isso deve ser um ASN público quando o PeeringType for AzurePublicPeering.

Propriedades do parâmetro

Tipo:UInt32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PeeringType

Os valores aceitáveis para este parâmetro são: AzurePrivatePeering, AzurePublicPeeringe MicrosoftPeering

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PrimaryPeerAddressPrefix

Esse é o intervalo de endereços IP para o caminho de roteamento primário dessa relação de emparelhamento. Deve ser uma sub-rede CIDR /30. O primeiro endereço numerado ímpar nesta sub-rede deve ser atribuído à interface do roteador. Azure configurará o próximo endereço com numeração uniforme para a interface do roteador Azure.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RouteFilter

Este é um objeto RouteFilter existente.

Propriedades do parâmetro

Tipo:PSRouteFilter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

MicrosoftPeeringConfigRoutFilter
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-RouteFilterId

Essa é a ID de recurso de um objeto RouteFilter existente.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

MicrosoftPeeringConfigRoutFilterId
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SecondaryPeerAddressPrefix

Esse é o intervalo de endereços IP para o caminho de roteamento secundário dessa relação de emparelhamento. Deve ser uma sub-rede CIDR /30. O primeiro endereço numerado ímpar nesta sub-rede deve ser atribuído à interface do roteador. Azure configurará o próximo endereço com numeração uniforme para a interface do roteador Azure.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SharedKey

Esse é um hash MD5 opcional usado como uma chave pré-compartilhada para a configuração de emparelhamento.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VlanId

Esse é o número de ID da VLAN atribuída para esse emparelhamento.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSExpressRouteCircuit

String

PSRouteFilter

Boolean

Saídas

PSExpressRouteCircuit