次の方法で共有

Add-AzureRmExpressRouteCircuitPeeringConfig

  • リファレンス
モジュール:
AzureRM.Network

ExpressRoute 回線にピアリング構成を追加します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

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

説明

Add-AzureRmExpressRouteCircuitPeeringConfig コマンドレットは、ExpressRoute 回線にピアリング構成を追加します。 ExpressRoute 回線は、パブリック インターネットではなく接続プロバイダーを使用して、オンプレミス ネットワークを Microsoft クラウドに接続します。 Add-AzureRmExpressRouteCircuitPeeringConfig を実行した後、Set-AzureRmExpressRouteCircuit コマンドレットを呼び出して構成をアクティブ化する必要があることに注意してください。

例

例 1: 既存の ExpressRoute 回線にピアを追加する

$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  = 200
}
Add-AzureRmExpressRouteCircuitPeeringConfig @parameters
Set-AzureRmExpressRouteCircuit -ExpressRouteCircuit $circuit

パラメーター

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ExpressRouteCircuit

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

型:PSExpressRouteCircuit
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-LegacyMode

ピアリングのレガシ モード

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-MicrosoftConfigAdvertisedPublicPrefixes

MicrosoftPeering の PeeringType の場合は、BGP セッション経由でアドバタイズする予定のすべてのプレフィックスの一覧を指定する必要があります。 パブリック IP アドレス プレフィックスのみが受け入れられます。 一連のプレフィックスを送信する予定の場合は、コンマ区切りのリストを送信できます。 これらのプレフィックスは、ルーティング レジストリ名 (RIR/IRR) に登録する必要があります。

型:List<T>[String]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MicrosoftConfigCustomerAsn

ピアリング AS 番号に登録されていないプレフィックスをアドバタイズする場合は、そのプレフィックスを登録する AS 番号を指定できます。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MicrosoftConfigRoutingRegistryName

AS 番号とプレフィックスが登録されるルーティング レジストリ名 (RIR/IRR)。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

追加するピアリング関係の名前。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PeerAddressType

PeerAddressType

型:String
指定可能な値:IPv4, IPv6
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PeerASN

ExpressRoute 回線の AS 番号。 PeeringType が AzurePublicPeering の場合、これはパブリック ASN である必要があります。

型:UInt32
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PeeringType

このパラメーターに使用できる値は、次のとおりです。 AzurePrivatePeeringAzurePublicPeeringMicrosoftPeering

型:String
指定可能な値:AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PrimaryPeerAddressPrefix

これは、このピアリング関係のプライマリ ルーティング パスの IP アドレス範囲です。 これは /30 CIDR サブネットである必要があります。 このサブネット内の最初の奇数のアドレスは、ルーター インターフェイスに割り当てる必要があります。 Azure は、Azure ルーター インターフェイスに対して次の偶数アドレスを構成します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RouteFilter

これは既存の RouteFilter オブジェクトです。

型:PSRouteFilter
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-RouteFilterId

これは、既存の RouteFilter オブジェクトのリソース ID です。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SecondaryPeerAddressPrefix

これは、このピアリング関係のセカンダリ ルーティング パスの IP アドレス範囲です。 これは /30 CIDR サブネットである必要があります。 このサブネット内の最初の奇数のアドレスは、ルーター インターフェイスに割り当てる必要があります。 Azure は、Azure ルーター インターフェイスに対して次の偶数アドレスを構成します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SharedKey

これは、ピアリング構成の事前共有キーとして使用されるオプションの MD5 ハッシュです。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VlanId

これは、このピアリングに割り当てられた VLAN の ID 番号です。

型:Int32
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

PSExpressRouteCircuit

パラメーター: ExpressRouteCircuit (ByValue)

String

PSRouteFilter

Boolean

出力

PSExpressRouteCircuit