Set-AzExpressRouteCircuitConnectionConfig

Express Route 回線のプライベート ピアリングで作成された回線接続構成を更新します。

構文

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

説明

Set-AzExpressRouteCircuitConnectionConfig コマンドレットは、ExpressRoute 回線のプライベート ピアリングで作成された回線接続構成を更新します。 これにより、リージョンまたはサブスクリプション間で 2 つの Express Route 回線をピアリングできます。 Set-AzExpressRouteCircuitConnectionConfig を実行する前に、Add-AzExpressRouteCircuitConnectionConfig を使用して回線接続を追加する必要があることに注意してください。 また、Set-AzExpressRouteCircuitPeeringConfig を実行した後、Set-AzExpressRouteCircuit コマンドレットを呼び出して構成をアクティブにする必要があります。

例 1: 回線接続リソースを既存の ExpressRoute 回線に更新する

$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

例 2: 既存の ExpressRoute 回線への配管を使用して回線接続構成を設定する

$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

パラメーター

-AddressPrefix

IPv4 トンネル用の Express Route 回線間に VxLan トンネルを作成するための、/29 以上の顧客アドレス空間。 または/125 以上の顧客アドレス空間を使用して、IPv6 トンネル用の Express Route 回線間に VxLan トンネルを作成します。

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AddressPrefixType

アドレス プレフィックスが属するアドレス ファミリを指定します。

Type:String
Accepted values:IPv4, IPv6
Position:Named
Default value:IPv4
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthorizationKey

別のサブスクリプションで Express Route 回線をピアリングするための承認キー。 ピア回線での承認は、既存のコマンドを使用して作成できます。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpressRouteCircuit

変更される ExpressRoute 回線。 これは、Get-AzExpressRouteCircuit コマンドレットによって返される Azure オブジェクトです。

Type:PSExpressRouteCircuit
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

追加する回線接続リソースの名前。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PeerExpressRouteCircuitPeering

現在の回線とピアリングされるリモート回線のプライベート ピアリングのリソース ID。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

PSExpressRouteCircuit

String

出力

PSExpressRouteCircuit