New-AzVirtualHubBgpConnection

モジュール:

Az.Network

New-AzVirtualHubBgpConnection コマンドレットは、Virtual WAN ハブに接続された仮想ネットワーク内の BGP 対応ピアと Azure Virtual WAN ハブ ルーターをピアリングする HubBgpConnection リソースを作成します。

構文

New-AzVirtualHubBgpConnection
   -ResourceGroupName <String>
   -VirtualHubName <String>
   -PeerIp <String>
   -PeerAsn <UInt32>
   -Name <String>
   -VirtualHubVnetConnection <PSHubVirtualNetworkConnection>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzVirtualHubBgpConnection
   -ResourceGroupName <String>
   -VirtualHubName <String>
   -PeerIp <String>
   -PeerAsn <UInt32>
   -Name <String>
   -VirtualHubVnetConnectionId <String>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzVirtualHubBgpConnection
   -PeerIp <String>
   -PeerAsn <UInt32>
   -Name <String>
   -VirtualHubVnetConnection <PSHubVirtualNetworkConnection>
   -VirtualHub <PSVirtualHub>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzVirtualHubBgpConnection
   -PeerIp <String>
   -PeerAsn <UInt32>
   -Name <String>
   -VirtualHubVnetConnection <PSHubVirtualNetworkConnection>
   -VirtualHubId <String>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzVirtualHubBgpConnection
   -PeerIp <String>
   -PeerAsn <UInt32>
   -Name <String>
   -VirtualHubVnetConnectionId <String>
   -VirtualHub <PSVirtualHub>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzVirtualHubBgpConnection
   -PeerIp <String>
   -PeerAsn <UInt32>
   -Name <String>
   -VirtualHubVnetConnectionId <String>
   -VirtualHubId <String>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzVirtualHubBgpConnection コマンドレットは、仮想 WAN ハブに接続された仮想ネットワーク内の BGP 対応ピアと Azure Virtual WAN ハブ ルーターをピアリングする HubBgpConnection リソースを作成します。

例

例 1

New-AzResourceGroup -Location "West US" -Name "testRG"
$frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name frontendSubnet -AddressPrefix "192.168.1.0/24"
$backendSubnet  = New-AzVirtualNetworkSubnetConfig -Name backendSubnet  -AddressPrefix "192.168.2.0/24"
$remoteVirtualNetwork = New-AzVirtualNetwork -Name "testVirtualNetwork" -ResourceGroupName "testRG" -Location "West US" -AddressPrefix "192.168.0.0/16" -Subnet $frontendSubnet,$backendSubnet
$virtualWan = New-AzVirtualWan -ResourceGroupName "testRG" -Name "testWan" -Location "West US"
New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "testHub" -AddressPrefix "10.0.1.0/24"
$hubVnetConnection = New-AzVirtualHubVnetConnection -ResourceGroupName "testRG" -VirtualHubName "testHub" -Name "testVnetConnection" -RemoteVirtualNetwork $remoteVirtualNetwork
New-AzVirtualHubBgpConnection -ResourceGroupName "testRG" -VirtualHubName "testHub" -PeerIp 192.168.1.5 -PeerAsn 20000 -Name "testBgpConnection" -VirtualHubVnetConnection $hubVnetConnection

Name                        : testBgpConnection
Id                          : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/testHub/bgpConnections/testBgpConnection
HubVirtualNetworkConnection : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/testHub/hubVirtualNetworkConnections/testVnetConnection
PeerAsn                     : 20000
PeerIp                      : 192.168.1.5

上記では、米国西部にリソース グループ Virtual WAN、Virtual Network、Virtual WAN ハブを作成し、その仮想ネットワークを Azure 内のそのリソース グループ内の Virtual WAN ハブに接続します。 その後、仮想 WAN ハブ BGP 接続が作成され、仮想ネットワークにデプロイされたネットワーク アプライアンスと Virtual WAN ハブがピアリングされます。

例 2

$hubVnetConnection = Get-AzVirtualHubVnetConnection -ResourceGroupName "testRG" -VirtualHubName "testHub" -Name "testVnetConnection"
Get-AzVirtualHub -ResourceGroupName "testRG" -Name "testHub" | New-AzVirtualHubBgpConnection -PeerIp 192.168.1.5 -PeerAsn 20000 -Name "testBgpConnection" -VirtualHubVnetConnection $hubVnetConnection

Name                        : testBgpConnection
Id                          : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/testHub/bgpConnections/testBgpConnection
HubVirtualNetworkConnection : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/virtualHubs/testHub/hubVirtualNetworkConnections/testVnetConnection
PeerAsn                     : 20000
PeerIp                      : 192.168.1.5

上記では、Get-AzVirtualHub からの出力で PowerShell パイプを使用して、既存の Virtual WAN ハブと Virtual WAN Hub Vnet 接続用の Virtual WAN ハブ BGP 接続を作成します。

パラメーター

-AsJob

バックグラウンドでコマンドレットを実行する

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

-Confirm

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

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

-DefaultProfile

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

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

-Name

リソースの名前。

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

-PeerAsn

ピア ASN。

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

-PeerIp

ピア IP。

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

-ResourceGroupName

リソース グループ名。

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

-VirtualHub

仮想ハブ リソース。

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

-VirtualHubId

仮想ハブのリソース ID。

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

-VirtualHubName

仮想ハブ名。

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

-VirtualHubVnetConnection

VirtualHubVnetConnection リソース。

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

-VirtualHubVnetConnectionId

VirtualHubVnetConnection リソース ID。

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

-WhatIf

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

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

入力

PSVirtualHub

PSHubVirtualNetworkConnection

String

出力

PSBgpConnection

関連リンク

• Get-AzVirtualHubBgpConnection
• Remove-AzVirtualHubBgpConnection
• Update-AzVirtualHubBgpConnection