Compartilhar via


Set-AzExpressRouteCircuitPeeringConfig

Salva uma configuração de emparelhamento do ExpressRoute modificada.

Sintaxe

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

O set-AzExpressRouteCircuitPeeringConfig cmdlets salva uma configuração de emparelhamento do ExpressRoute modificada de volta para o Azure.

Exemplos

Exemplo 1: alterar uma configuração de emparelhamento 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  = 201
}
Set-AzExpressRouteCircuitPeeringConfig @parameters
Set-AzExpressRouteCircuit -ExpressRouteCircuit $circuit

Exemplo 2

Salva uma configuração de emparelhamento do ExpressRoute modificada. (gerado automaticamente)

Set-AzExpressRouteCircuitPeeringConfig -ExpressRouteCircuit <PSExpressRouteCircuit> -Name 'cert01' -PeerASN 100 -PeerAddressType IPv4 -PeeringType AzurePrivatePeering -PrimaryPeerAddressPrefix '123.0.0.0/30' -SecondaryPeerAddressPrefix '123.0.0.4/30' -VlanId 300

Exemplo 3

Salva uma configuração de emparelhamento do ExpressRoute modificada. (gerado automaticamente)

Set-AzExpressRouteCircuitPeeringConfig -ExpressRouteCircuit <PSExpressRouteCircuit> -MicrosoftConfigAdvertisedPublicPrefixes <String[]> -MicrosoftConfigCustomerAsn <Int32> -MicrosoftConfigRoutingRegistryName <String> -Name 'cert01' -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.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ExpressRouteCircuit

O objeto de circuito do ExpressRoute que contém a configuração de emparelhamento a ser modificada.

Tipo:PSExpressRouteCircuit
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LegacyMode

O modo herdado do emparelhamento

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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ço IP público 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).

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MicrosoftConfigRoutingRegistryName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

O nome da configuração de emparelhamento a ser modificada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PeerAddressType

PeerAddressType

Tipo:String
Valores aceitos:IPv4, IPv6
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PeerASN

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

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PeeringType

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

Tipo:String
Valores aceitos:AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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. O Azure configurará o próximo endereço com numeração uniforme para a interface do roteador do Azure.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RouteFilter

Este é um objeto RouteFilter existente.

Tipo:PSRouteFilter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-RouteFilterId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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. O Azure configurará o próximo endereço com numeração uniforme para a interface do roteador do Azure.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SharedKey

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VlanId

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSExpressRouteCircuit

String

PSRouteFilter

Boolean

Saídas

PSExpressRouteCircuit