Add-AzExpressRouteCircuitPeeringConfig
ExpressRoute 回線にピアリング構成を追加します。
構文
SetByResource (既定)
Add-AzExpressRouteCircuitPeeringConfig
-Name <String>
-ExpressRouteCircuit <PSExpressRouteCircuit>
-PeeringType <String>
-PeerASN <UInt32>
-PrimaryPeerAddressPrefix <String>
-SecondaryPeerAddressPrefix <String>
-VlanId <Int32>
[-SharedKey <String>]
[-MicrosoftConfigAdvertisedPublicPrefixes <String[]>]
[-MicrosoftConfigCustomerAsn <Int32>]
[-MicrosoftConfigRoutingRegistryName <String>]
[-PeerAddressType <String>]
[-LegacyMode <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
MicrosoftPeeringConfigRoutFilterId
Add-AzExpressRouteCircuitPeeringConfig
-Name <String>
-ExpressRouteCircuit <PSExpressRouteCircuit>
-PeeringType <String>
-PeerASN <UInt32>
-PrimaryPeerAddressPrefix <String>
-SecondaryPeerAddressPrefix <String>
-VlanId <Int32>
-RouteFilterId <String>
[-SharedKey <String>]
[-MicrosoftConfigAdvertisedPublicPrefixes <String[]>]
[-MicrosoftConfigCustomerAsn <Int32>]
[-MicrosoftConfigRoutingRegistryName <String>]
[-PeerAddressType <String>]
[-LegacyMode <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
MicrosoftPeeringConfigRoutFilter
Add-AzExpressRouteCircuitPeeringConfig
-Name <String>
-ExpressRouteCircuit <PSExpressRouteCircuit>
-PeeringType <String>
-PeerASN <UInt32>
-PrimaryPeerAddressPrefix <String>
-SecondaryPeerAddressPrefix <String>
-VlanId <Int32>
-RouteFilter <PSRouteFilter>
[-SharedKey <String>]
[-MicrosoftConfigAdvertisedPublicPrefixes <String[]>]
[-MicrosoftConfigCustomerAsn <Int32>]
[-MicrosoftConfigRoutingRegistryName <String>]
[-PeerAddressType <String>]
[-LegacyMode <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Add-AzExpressRouteCircuitPeeringConfig コマンドレットは、ExpressRoute 回線にピアリング構成を追加します。 ExpressRoute 回線は、パブリック インターネットではなく接続プロバイダーを使用して、オンプレミス ネットワークを Microsoft クラウドに接続します。
Add-AzExpressRouteCircuitPeeringConfig を実行した後、Set-AzExpressRouteCircuit コマンドレットを呼び出して構成をアクティブ化する必要があることに注意してください。
例
例 1: 既存の ExpressRoute 回線にピアを追加する
$circuit = Get-AzExpressRouteCircuit -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-AzExpressRouteCircuitPeeringConfig @parameters
Set-AzExpressRouteCircuit -ExpressRouteCircuit $circuit
例 2
ExpressRoute 回線にピアリング構成を追加します。 (autogenerated)
Add-AzExpressRouteCircuitPeeringConfig -ExpressRouteCircuit <PSExpressRouteCircuit> -MicrosoftConfigAdvertisedPublicPrefixes <String[]> -MicrosoftConfigCustomerAsn <Int32> -MicrosoftConfigRoutingRegistryName <String> -Name 'AzurePrivatePeering' -PeerASN 100 -PeerAddressType IPv4 -PeeringType AzurePrivatePeering -PrimaryPeerAddressPrefix '123.0.0.0/30' -SecondaryPeerAddressPrefix '123.0.0.4/30' -VlanId 300
パラメーター
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
パラメーターのプロパティ
| 型: | IAzureContextContainer
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExpressRouteCircuit
変更される ExpressRoute 回線。 これは、 Get-AzExpressRouteCircuit コマンドレットによって返される Azure オブジェクトです。
パラメーターのプロパティ
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LegacyMode
ピアリングのレガシ モード
パラメーターのプロパティ
| 型: | Boolean
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-MicrosoftConfigAdvertisedPublicPrefixes
MicrosoftPeering の PeeringType の場合は、BGP セッション経由でアドバタイズする予定のすべてのプレフィックスの一覧を指定する必要があります。 パブリック IP アドレス プレフィックスのみが受け入れられます。 プレフィックスのセットを送信する予定の場合は、コンマ区切りリストを送信できます。 これらのプレフィックスは、ルーティング レジストリ名 (RIR/IRR) に登録する必要があります。
パラメーターのプロパティ
| 型: | String[]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MicrosoftConfigCustomerAsn
ピアリング AS 番号に登録されていないプレフィックスをアドバタイズする場合は、登録先の AS 番号を指定できます。
パラメーターのプロパティ
| 型: | Int32
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MicrosoftConfigRoutingRegistryName
AS 番号とプレフィックスが登録されるルーティング レジストリ名 (RIR/IRR)。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
追加するピアリング関係の名前。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PeerAddressType
PeerAddressType
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| 指定可能な値: | IPv4, IPv6 |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-PeerASN
ExpressRoute 回線の AS 番号。 PeeringType が AzurePublicPeering の場合、これはパブリック ASN である必要があります。
パラメーターのプロパティ
| 型: | UInt32
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PeeringType
このパラメーターに使用できる値は、 AzurePrivatePeering、 AzurePublicPeering、および MicrosoftPeering
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| 指定可能な値: | AzurePrivatePeering, AzurePublicPeering, MicrosoftPeering |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PrimaryPeerAddressPrefix
これは、このピアリング関係のプライマリ ルーティング パスの IP アドレス範囲です。 これは /30 CIDR サブネットである必要があります。 このサブネット内の最初の奇数のアドレスは、ルーター インターフェイスに割り当てる必要があります。 Azure は、Azure ルーター インターフェイスに対して次の偶数アドレスを構成します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RouteFilter
これは既存の RouteFilter オブジェクトです。
パラメーターのプロパティ
パラメーター セット
MicrosoftPeeringConfigRoutFilter
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-RouteFilterId
これは、既存の RouteFilter オブジェクトのリソース ID です。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
MicrosoftPeeringConfigRoutFilterId
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-SecondaryPeerAddressPrefix
これは、このピアリング関係のセカンダリ ルーティング パスの IP アドレス範囲です。 これは /30 CIDR サブネットである必要があります。 このサブネット内の最初の奇数のアドレスは、ルーター インターフェイスに割り当てる必要があります。 Azure は、Azure ルーター インターフェイスに対して次の偶数アドレスを構成します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SharedKey
これは、ピアリング構成の事前共有キーとして使用されるオプションの MD5 ハッシュです。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VlanId
これは、このピアリングに割り当てられた VLAN の ID 番号です。
パラメーターのプロパティ
| 型: | Int32
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力