次の方法で共有


New-AzVirtualNetworkGatewayConnection

仮想ネットワーク ゲートウェイとオンプレミス VPN デバイスの間にサイト間 VPN 接続を作成します。

構文

SetByResource (既定)

New-AzVirtualNetworkGatewayConnection
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -VirtualNetworkGateway1 <PSVirtualNetworkGateway>
    -ConnectionType <String>
    [-AuthorizationKey <String>]
    [-VirtualNetworkGateway2 <PSVirtualNetworkGateway>]
    [-LocalNetworkGateway2 <PSLocalNetworkGateway>]
    [-RoutingWeight <Int32>]
    [-DpdTimeoutInSeconds <Int32>]
    [-ConnectionMode <String>]
    [-SharedKey <String>]
    [-Peer <PSPeering>]
    [-EnableBgp <Boolean>]
    [-UseLocalAzureIpAddress]
    [-Tag <Hashtable>]
    [-Force]
    [-UsePolicyBasedTrafficSelectors <Boolean>]
    [-IpsecPolicies <PSIpsecPolicy[]>]
    [-TrafficSelectorPolicy <PSTrafficSelectorPolicy[]>]
    [-ConnectionProtocol <String>]
    [-IngressNatRule <PSResourceId[]>]
    [-EgressNatRule <PSResourceId[]>]
    [-GatewayCustomBgpIpAddress <PSGatewayCustomBgpIpConfiguration[]>]
    [-AsJob]
    [-ExpressRouteGatewayBypass]
    [-EnablePrivateLinkFastPath]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByResourceId

New-AzVirtualNetworkGatewayConnection
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -VirtualNetworkGateway1 <PSVirtualNetworkGateway>
    -ConnectionType <String>
    [-AuthorizationKey <String>]
    [-VirtualNetworkGateway2 <PSVirtualNetworkGateway>]
    [-LocalNetworkGateway2 <PSLocalNetworkGateway>]
    [-RoutingWeight <Int32>]
    [-DpdTimeoutInSeconds <Int32>]
    [-ConnectionMode <String>]
    [-SharedKey <String>]
    [-PeerId <String>]
    [-EnableBgp <Boolean>]
    [-UseLocalAzureIpAddress]
    [-Tag <Hashtable>]
    [-Force]
    [-UsePolicyBasedTrafficSelectors <Boolean>]
    [-IpsecPolicies <PSIpsecPolicy[]>]
    [-TrafficSelectorPolicy <PSTrafficSelectorPolicy[]>]
    [-ConnectionProtocol <String>]
    [-IngressNatRule <PSResourceId[]>]
    [-EgressNatRule <PSResourceId[]>]
    [-GatewayCustomBgpIpAddress <PSGatewayCustomBgpIpConfiguration[]>]
    [-AsJob]
    [-ExpressRouteGatewayBypass]
    [-EnablePrivateLinkFastPath]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

仮想ネットワーク ゲートウェイとオンプレミス VPN デバイスの間にサイト間 VPN 接続を作成します。

例 1

$vnetgw1 = Get-AzVirtualNetworkGateway -ResourceGroupName "Rg1" -Name "gw1"
$vnetgw2 = Get-AzVirtualNetworkGateway -ResourceGroupName "Rg1" -Name "gw2"
New-AzVirtualNetworkGatewayConnection -Name conn-client-1 -ResourceGroupName "Rg1" -VirtualNetworkGateway1 $vnetgw1 -VirtualNetworkGateway2 $vnetgw2 -Location "eastus" -ConnectionType Vnet2Vnet -SharedKey 'a1b2c3d4e5'

例 2 既存の仮想ネットワーク ゲートウェイ接続への IngressNatRule/EgressNatRule の追加/更新

$vnetgw1 = Get-AzVirtualNetworkGateway -ResourceGroupName "Rg1" -Name "vnetgw1"
$vnetgw2 = Get-AzVirtualNetworkGateway -ResourceGroupName "Rg1" -Name "vnetgw2"
$ingressnatrule = Get-AzVirtualNetworkGatewayNatRule -ResourceGroupName "Rg1" -Name "natRule1" -ParentResourceName vnetgw1
$egressnatrule = Get-AzVirtualNetworkGatewayNatRule -ResourceGroupName "Rg1" -Name "natRule2" -ParentResourceName vnetgw1
New-AzVirtualNetworkGatewayConnection -Name conn-client-1 -ResourceGroupName $RG1 -VirtualNetworkGateway1 $vnetgw1 -VirtualNetworkGateway2 $vnetgw2 -Location "eastus" -ConnectionType Vnet2Vnet -SharedKey 'a1b2c3d4e5' `
-IngressNatRule $ingressnatrule -EgressNatRule $egressnatrule

最初のコマンドは、種類が IngressSnat である natRule1 という名前の仮想ネットワーク ゲートウェイ natRule を取得します。 2 番目のコマンドは、種類が EgressSnat である natRule2 という名前の仮想ネットワーク ゲートウェイ natRule を取得します。 3 番目のコマンドは、イングレスとエグレス NatRules を使用して、この新しい仮想ネットワーク ゲートウェイ接続を作成します。

例 3 仮想ネットワーク ゲートウェイ接続に GatewayCustomBgpIpAddress を追加する

$LocalnetGateway = Get-AzLocalNetworkGateway -ResourceGroupName "PS_testing" -name "testLng"
$gateway = Get-AzVirtualNetworkGateway -ResourceGroupName PS_testing -ResourceName testGw
$address = New-AzGatewayCustomBgpIpConfigurationObject -IpConfigurationId "/subscriptions/83704d68-d560-4c67-b1c7-12404db89dc3/resourceGroups/PS_testing/providers/Microsoft.Network/virtualNetworkGateways/testGw/ipConfigurations/default" -CustomBgpIpAddress "169.254.21.1"

New-AzVirtualNetworkGatewayConnection -ResourceGroupName "PS_testing" -name "Conn" -location "eastus" -VirtualNetworkGateway1 $gateway -LocalNetworkGateway2 $localnetGateway -ConnectionType IPsec -RoutingWeight 3 -SharedKey abc -GatewayCustomBgpIpAddress $address -EnableBgp $true

2 つのコマンドは、ローカル ネットワーク ゲートウェイと仮想ネットワーク ゲートウェイを取得します。 3 番目のコマンドは、AzGatewayCustomBgpIpConfigurationObject を作成します。 3 番目のコマンドは、GatewayCustomBgpIpAddress を使用して、この新しい仮想ネットワーク ゲートウェイ接続を作成します。

パラメーター

-AsJob

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-AuthorizationKey

AuthorizationKey。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Confirm

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ConnectionMode

仮想ネットワーク ゲートウェイ接続モード。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ConnectionProtocol

ゲートウェイ接続プロトコル:IKEv1/IKEv2

パラメーターのプロパティ

型:String
規定値:None
指定可能な値:IKEv1, IKEv2
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ConnectionType

ゲートウェイ接続の種類:IPsec/Vnet2Vnet/ExpressRoute/VPNClient

パラメーターのプロパティ

型:String
規定値:None
指定可能な値:IPsec, Vnet2Vnet, ExpressRoute, VPNClient
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-DefaultProfile

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

パラメーターのプロパティ

型:IAzureContextContainer
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DpdTimeoutInSeconds

接続のデッド ピア検出タイムアウト (秒単位)。

パラメーターのプロパティ

型:Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-EgressNatRule

この接続に関連付けられているエグレス NAT 規則の一覧。

パラメーターのプロパティ

型:

PSResourceId[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-EnableBgp

S2S VPN トンネル経由で BGP セッションを確立するかどうか

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-EnablePrivateLinkFastPath

プライベート リンクにアクセスするときは、ExpressRoute ゲートウェイをバイパスします。 ExpressRoute FastPath (ExpressRouteGatewayBypass) を有効にする必要があります。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ExpressRouteGatewayBypass

ゲートウェイをバイパスして高速仮想ネットワーク アクセスを使用するかどうか

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Force

リソースを上書きする場合は、確認を求めないでください

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-GatewayCustomBgpIpAddress

この接続で使用される仮想ネットワーク ゲートウェイの GatewayCustomBgpIpAddress。

パラメーターのプロパティ

型:

PSGatewayCustomBgpIpConfiguration[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-IngressNatRule

この接続に関連付けられているイングレス NAT 規則の一覧。

パラメーターのプロパティ

型:

PSResourceId[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IpsecPolicies

IPSec ポリシーの一覧。

パラメーターのプロパティ

型:

PSIpsecPolicy[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-LocalNetworkGateway2

ローカル ネットワーク ゲートウェイ。

パラメーターのプロパティ

型:PSLocalNetworkGateway
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Location

存在します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Name

リソースの名前。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:リソース名

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Peer

Peer

パラメーターのプロパティ

型:PSPeering
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SetByResource
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-PeerId

ピアID

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SetByResourceId
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ResourceGroupName

リソース グループ名。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-RoutingWeight

RoutingWeight。

パラメーターのプロパティ

型:Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-SharedKey

Ipsec 共有キー。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Tag

リソース タグを表すハッシュテーブル。

パラメーターのプロパティ

型:Hashtable
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-TrafficSelectorPolicy

トラフィック セレクター ポリシーの一覧。

パラメーターのプロパティ

型:

PSTrafficSelectorPolicy[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-UseLocalAzureIpAddress

この S2S VPN トンネルに PrivateIP を使用するかどうか

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-UsePolicyBasedTrafficSelectors

S2S 接続にポリシー ベースのトラフィック セレクターを使用するかどうか

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-VirtualNetworkGateway1

最初の仮想ネットワーク ゲートウェイ。

パラメーターのプロパティ

型:PSVirtualNetworkGateway
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-VirtualNetworkGateway2

2 つ目の仮想ネットワーク ゲートウェイ。

パラメーターのプロパティ

型:PSVirtualNetworkGateway
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

String

PSVirtualNetworkGateway

PSLocalNetworkGateway

Int32

PSPeering

Boolean

SwitchParameter

Hashtable

PSIpsecPolicy

PSTrafficSelectorPolicy

PSGatewayCustomBgpIpConfiguration

出力

PSVirtualNetworkGatewayConnection