Compartilhar via

Set-AzExpressRouteCircuitConnectionConfig

  • Referência
Módulo:
Az.Network

Atualiza uma configuração de conexão de circuito criada em emparelhamentos privados para um Circuito de Rota Expressa.

Sintaxe

Set-AzExpressRouteCircuitConnectionConfig
   [-Name] <String>
   [-ExpressRouteCircuit] <PSExpressRouteCircuit>
   [-AddressPrefix] <String>
   [-AddressPrefixType <String>]
   [-AuthorizationKey <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzExpressRouteCircuitConnectionConfig
   [-Name] <String>
   [-ExpressRouteCircuit] <PSExpressRouteCircuit>
   [-PeerExpressRouteCircuitPeering] <String>
   [-AddressPrefix] <String>
   [-AddressPrefixType <String>]
   [-AuthorizationKey <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-AzExpressRouteCircuitConnectionConfig atualiza uma configuração de conexão de circuito criada no emparelhamento privado para um circuito do ExpressRoute. Isso permite emparelhar dois Circuitos de Rota Expressa entre regiões ou assinaturas. Observe que, antes de executar Set-AzExpressRouteCircuitConnectionConfig você deve adicionar a conexão de circuito usando Add-AzExpressRouteCircuitConnectionConfig. Além disso, depois de executar Set-AzExpressRouteCircuitPeeringConfig, você deve chamar o cmdlet Set-AzExpressRouteCircuit para ativar a configuração.

Exemplos

Exemplo 1: atualizar um recurso de conexão de circuito para um circuito do ExpressRoute existente

$circuit_init = Get-AzExpressRouteCircuit -Name $initiatingCircuitName -ResourceGroupName $rg
$circuit_peer = Get-AzExpressRouteCircuit -Name $peeringCircuitName -ResourceGroupName $rg
$addressSpace = 'aa:bb::0/125'
$addressPrefixType = 'IPv6'
Set-AzExpressRouteCircuitConnectionConfig -Name $circuitConnectionName -ExpressRouteCircuit $circuit_init -PeerExpressRouteCircuitPeering $circuit_peer.Peerings[0].Id -AddressPrefix $addressSpace -AddressPrefixType $addressPrefixType -AuthorizationKey $circuit_peer.Authorizations[0].AuthorizationKey
Set-AzExpressRouteCircuit -ExpressRouteCircuit $circuit_init

Exemplo 2: Definir uma configuração de conexão de circuito usando o Piping para um Circuito do ExpressRoute existente

$circuit_peer = Get-AzExpressRouteCircuit -Name $peeringCircuitName -ResourceGroupName $rg
$addressSpace = '60.0.0.0/29'
Get-AzExpressRouteCircuit -Name $initiatingCircuitName -ResourceGroupName $rg|Set-AzExpressRouteCircuitConnectionConfig -Name $circuitConnectionName -PeerExpressRouteCircuitPeering $circuit_peer.Peerings[0].Id -AddressPrefix $addressSpace -AuthorizationKey $circuit_peer.Authorizations[0].AuthorizationKey |Set-AzExpressRouteCircuit

Parâmetros

-AddressPrefix

Um espaço mínimo de endereço do cliente /29 para criar túneis VxLan entre circuitos de rota expressa para túneis IPv4. ou um mínimo de /125 espaço de endereço do cliente para criar túneis VxLan entre circuitos de rota expressa para túneis IPv6.

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

-AddressPrefixType

Especifica a família de endereços à qual o prefixo de endereço pertence.

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

-AuthorizationKey

Chave de autorização para emparelhar o Circuito de Rota Expressa em outra assinatura. A autorização no circuito par pode ser criada usando comandos existentes.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-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 circuito do ExpressRoute que está sendo modificado. Este é o objeto do Azure retornado pelo cmdlet Get-AzExpressRouteCircuit.

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

-Name

O nome do recurso de conexão de circuito a ser adicionado.

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

-PeerExpressRouteCircuitPeering

ID de recurso para emparelhamento privado de circuito remoto que será emparelhada com o circuito atual.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

PSExpressRouteCircuit

String

Saídas

PSExpressRouteCircuit