Compartilhar via


Set-AzExpressRouteCircuitConnectionConfig

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

Sintaxe

SetByResource (Default)

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

SetByResourceId

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.

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-AddressPrefixType

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

Propriedades do parâmetro

Tipo:String
Valor padrão:IPv4
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:False
Valor dos argumentos restantes: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.

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

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

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

-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:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-PeerExpressRouteCircuitPeering

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

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

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

Saídas

PSExpressRouteCircuit