Partilhar via


Set-AzureRmExpressRouteCircuitPeeringConfig

Salva uma configuração de emparelhamento de Rota Expressa modificada.

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

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

Os cmdlets Set-AzureRmExpressRouteCircuitPeeringConfig salvam uma configuração de emparelhamento de Rota Expressa modificada de volta ao Azure.

Exemplos

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

Parâmetros

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ExpressRouteCircuit

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

Tipo:PSExpressRouteCircuit
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-LegacyMode

O modo herdado do emparelhamento

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-MicrosoftConfigAdvertisedPublicPrefixes

Para um PeeringType de MicrosoftPeering, você deve fornecer uma lista de todos os prefixos que você planeja anunciar na sessão BGP. São aceites apenas prefixos de endereços IP públicos. Pode enviar uma lista separada por vírgulas se pretender enviar um conjunto de prefixos. Esses prefixos devem ser registrados para você em um Nome de Registro de Roteamento (RIR / IRR).

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MicrosoftConfigCustomerAsn

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

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MicrosoftConfigRoutingRegistryName

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PeerAddressType

PeerAddressType

Tipo:String
Valores aceites:IPv4, IPv6
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PeerASN

O número AS do seu circuito ExpressRoute. Este deve ser um ASN público quando o PeeringType é AzurePublicPeering.

Tipo:UInt32
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PeeringType

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

Tipo:String
Valores aceites:AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PrimaryPeerAddressPrefix

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RouteFilter

Este é um objeto RouteFilter existente.

Tipo:PSRouteFilter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-RouteFilterId

Este é o Id do recurso de um objeto RouteFilter existente.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SecondaryPeerAddressPrefix

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SharedKey

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VlanId

Este é o número de ID da VLAN atribuída para este emparelhamento.

Tipo:Int32
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

PSExpressRouteCircuit

Parâmetros: ExpressRouteCircuit (ByValue)

String

PSRouteFilter

Boolean

Saídas

PSExpressRouteCircuit