次の方法で共有


Set-AzVpnClientIpsecParameter

既存の仮想ネットワーク ゲートウェイの vpn ipsec パラメーターを設定します。

構文

Set-AzVpnClientIpsecParameter
   -VirtualNetworkGatewayName <String>
   -ResourceGroupName <String>
   -VpnClientIPsecParameter <PSVpnClientIPsecParameters>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzVpnClientIpsecParameter
   -VirtualNetworkGatewayName <String>
   -ResourceGroupName <String>
   -VpnClientIPsecParameter <PSVpnClientIPsecParameters>
   -InputObject <PSVirtualNetworkGateway>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzVpnClientIpsecParameter
   -VirtualNetworkGatewayName <String>
   -ResourceGroupName <String>
   -VpnClientIPsecParameter <PSVpnClientIPsecParameters>
   -ResourceId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzVpnClientIpsecParameter コマンドレットは、既存の仮想ネットワーク ゲートウェイの vpn ipsec パラメーターを設定します。 仮想ネットワーク ゲートウェイが作成されると、ゲートウェイに既定の vpn ipsec ポリシーのセットが設定されます。 ポイント対サイト ユーザーが特定のカスタム ipsec ポリシーを使用して VPN Gateway に接続する場合、ユーザーはまず VPN Gateway でその ipsec ポリシーを設定する必要があります。 Set-AzVpnClientIpsecParameter は、これを行う方法を提供します。

例 1: カスタム vpn ipsec ポリシーを既存の仮想ネットワーク ゲートウェイに設定します。

$vpnclientipsecparams = New-AzVpnClientIpsecParameter -IpsecEncryption AES256 -IpsecIntegrity SHA256 -SALifeTime 86473 -SADataSize 429498 -IkeEncryption AES256 -IkeIntegrity SHA384 -DhGroup DHGroup2 -PfsGroup PFS2
$setvpnIpsecParams = Set-AzVpnClientIpsecParameter -VirtualNetworkGatewayName "ContosoLocalGateway" -ResourceGroupName "ContosoResourceGroup" -VpnClientIPsecParameter $vpnclientipsecparams

次の使用例は、ContosoResourceGroup という名前のリソース グループから ContosoVirtualGateway という名前の既存の仮想ネットワーク ゲートウェイにカスタム vpn ipsec ポリシーを設定します。 New-AzVpnClientIpsecParameter コマンドレットは、ResourceGroup 内の既存の仮想ネットワーク ゲートウェイに対してユーザーが設定できる、渡された 1 つまたはすべてのパラメーターの値を使用する vpn ipsec パラメーター オブジェクトを作成するために使用されます。 この作成された VpnClientIPsecParameters オブジェクトは Set-AzVpnClientIpsecParameter コマンドに渡され、上記の例に示すように、仮想ネットワーク ゲートウェイで指定された Vpn ipsec カスタム ポリシーを設定します。 このコマンドは、設定されたパラメーターを示す VpnClientIPsecParameters のオブジェクトを返します。

パラメーター

-Confirm

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

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

-DefaultProfile

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

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

-InputObject

仮想ネットワーク ゲートウェイ オブジェクト

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

-ResourceGroupName

リソース グループ名。

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

-ResourceId

Azure リソース ID。

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

-VirtualNetworkGatewayName

仮想ネットワーク ゲートウェイ名。

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

-VpnClientIPsecParameter

Vpn クライアントの ipsec パラメーター。 このパラメーター値は、PS コマンド let:New-AzVpnClientIpsecParameter を使用して構築できます。

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

-WhatIf

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

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

入力

PSVpnClientIPsecParameters

PSVirtualNetworkGateway

String

出力

PSVpnClientIPsecParameters