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 |
入力
出力
関連リンク
Azure PowerShell