Partager via


Add-AzExpressRouteCircuitConnectionConfig

Adds a circuit connection configuration to Private Peering of an Express Route Circuit.

Syntaxe

SetByResource (Par défaut)

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

SetByResourceId

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

Description

The Add-AzExpressRouteCircuitConnectionConfig cmdlet adds a circuit connection configuration to private peering for an ExpressRoute circuit. This allows peering two Express Route Circuits across regions or subscriptions.Note that, after running Add-AzExpressRouteCircuitConnectionConfig, you must call the Set-AzExpressRouteCircuit cmdlet to activate the configuration.

Exemples

Example 1: Add a circuit connection resource to an existing ExpressRoute circuit

$circuit_init = Get-AzExpressRouteCircuit -Name $initiatingCircuitName -ResourceGroupName $rg
$circuit_peer = Get-AzExpressRouteCircuit -Name $peeringCircuitName -ResourceGroupName $rg
$addressSpace = '60.0.0.0/29'
$addressPrefixType = 'IPv4'
Add-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

Example 2: Add a circuit connection configuration using Piping to an existing ExpressRoute Circuit

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

Paramètres

-AddressPrefix

A minimum /29 customer address space to create VxLan tunnels between Express Route Circuits for IPv4 tunnels. or a minimum of /125 customer address space to create VxLan tunnels between Express Route Circuits for IPv6 tunnels.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:3
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AddressPrefixType

This specifies the Address Family that address prefix belongs to.

Propriétés du paramètre

Type:String
Valeur par défaut:IPv4
Valeurs acceptées:IPv4, IPv6
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AuthorizationKey

Authorization Key to peer Express Route Circuit in another subscription. Authorization on peer circuit can be created using existing commands.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with azure.

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ExpressRouteCircuit

The ExpressRoute circuit being modified. This is Azure object returned by the Get-AzExpressRouteCircuit cmdlet.

Propriétés du paramètre

Type:PSExpressRouteCircuit
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

The name of the circuit connection resource to be added.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PeerExpressRouteCircuitPeering

Resource Id for Private Peering of remote circuit which will be peered with the current circuit.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

SetByResourceId
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Entrées

PSExpressRouteCircuit

String

Sorties

PSExpressRouteCircuit