Add-SCVPNConnection

リファレンス

モジュール:: VirtualMachineManager

仮想マシンネットワークに VPN 接続を追加します。

構文

Add-SCVPNConnection
   [-VMMServer <ServerConnection>]
   [-VMNetworkGateway] <VMNetworkGateway>
   [-Name <String>]
   [-Description <String>]
   [-TargetIPv4VPNAddress <String>]
   [-TargetIPv6VPNAddress <String>]
   [-EncryptionMethod <VPNEncryptionMethod>]
   [-IntegrityCheckMethod <VPNIntegrityCheckMethod>]
   [-CipherTransformConstants <VPNCipherTransformConstants>]
   [-AuthenticationTransformConstants <VPNAuthenticationTransformConstants>]
   [-PFSGroup <VPNPFSGroup>]
   [-DHGroup <VPNDHGroup>]
   -Protocol <VPNProtocol>
   [-AuthenticationMethod <VPNAuthenticationMethod>]
   [-Secret <RunAsAccount>]
   [-Certificate <ClientCertificate>]
   [-IPSecMainSALifeTimeSeconds <UInt32>]
   [-IPSecMainSALifeTimeKiloBytes <UInt32>]
   [-IPSecQuickSALifeTimeSeconds <UInt32>]
   [-IPSecQuickSALifeTimeKiloBytes <UInt32>]
   [-IPSecIdleDisconnectSeconds <UInt32>]
   [-LocalTrafficSelectors <TrafficSelector[]>]
   [-RemoteTrafficSelectors <TrafficSelector[]>]
   [-MaximumBandwidthInboundKbps <UInt64>]
   [-MaximumBandwidthOutboundKbps <UInt64>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Add-SCVPNConnection
   [-VMMServer <ServerConnection>]
   [-VMNetworkGateway] <VMNetworkGateway>
   [-Name <String>]
   [-Description <String>]
   [-TargetIPv4VPNAddress <String>]
   [-TargetIPv6VPNAddress <String>]
   -Protocol <VPNProtocol>
   [-MaximumBandwidthInboundKbps <UInt64>]
   [-MaximumBandwidthOutboundKbps <UInt64>]
   [-GRETunnel]
   [-GREKey <UInt32>]
   [-GREIPv4Address <String>]
   [-GREIPv6Address <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Add-SCVPNConnection
   [-VMMServer <ServerConnection>]
   [-VMNetworkGateway] <VMNetworkGateway>
   -NextHopNetwork <VMNetwork>
   [-Name <String>]
   [-Description <String>]
   -Protocol <VPNProtocol>
   [-MaximumBandwidthInboundKbps <UInt64>]
   [-MaximumBandwidthOutboundKbps <UInt64>]
   -IPAddresses <String[]>
   -PeerIPAddresses <String[]>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Add-SCVPNConnection コマンドレットは、仮想マシンネットワークに仮想プライベートネットワーク (VPN) 接続を追加して、Virtual Machine Manager (VMM) マネージドネットワークゲートウェイから別のエンドポイントへのサイト間トンネルを確立します。

例

例 1: VPN 接続を追加する

PS C:\> $VmNetworkGateway = Get-SCVMNetworkGateway -Name "VMGateway01"
PS C:\> $RunAsAccount = Get-SCRunAsAccount -ID "972567d5-96ad-472e-9790-831bae5fd69c" 
PS C:\> $VpnConnection = Add-SCVPNConnection -AuthenticationMethod "PSKOnly" -AuthenticationTransformConstants "SHA196" -CipherTransformConstants "AES256" -DHGroup "Group2" -EncryptionMethod "AES256" -IntegrityCheckMethod "SHA1" -PFSGroup "PFS2048" -Protocol "IKEv2" -Name "IPSec" -TargetIPv4VPNAddress "100.100.100.100" -Secret $RunAsAccount -VMNetworkGateway $VmNetworkGateway

最初のコマンドは、VMGateway01 という名前のネットワークゲートウェイを取得し、$VmNetworkGateway変数に格納します。

2 番目のコマンドは実行アカウントを取得し、$RunAsAccount変数に格納します。このアカウントは、VPN 接続を追加するために使用されます。

最後のコマンドは、$VmNetworkGateway内の仮想マシンネットワークゲートウェイに VPN 接続を追加し、$VpnConnection変数に格納します。

パラメーター

-AuthenticationMethod

仮想プライベートネットワーク (VPN) 認証方法を指定します。有効な値は PSKOnly、MachineCertificates です。

型:	VPNAuthenticationMethod
指定可能な値:	PSKOnly, MachineCertificates
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AuthenticationTransformConstants

仮想プライベートネットワーク (VPN) 変換定数を指定します。有効な値は次のとおりです。

SHA256128
MD596
SHA196
GCMAES128
GCMAES192
GCMAES256

型:	VPNAuthenticationTransformConstants
指定可能な値:	SHA256128, MD596, SHA196, GCMAES128, GCMAES192, GCMAES256, SHA256, None
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Certificate

セキュリティ証明書オブジェクトを指定します。

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

-CipherTransformConstants

仮想プライベートネットワーク暗号変換定数を指定します。有効な値は次のとおりです。

DES
DES3
AES128
AES192
AES256
GCMAES128
GCMAES192
GCMAES256

型:	VPNCipherTransformConstants
指定可能な値:	DES, DES3, AES128, AES192, AES256, GCMAES128, GCMAES192, GCMAES256, None
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

VPN 接続の説明を指定します。

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

-DHGroup

仮想プライベートネットワーク (VPN) Diffie-Hellman (DH) グループを指定します。有効な値は次のとおりです。

何一つ
Group1
Group2
Group14
ECP256
ECP384
Group24

型:	VPNDHGroup
指定可能な値:	None, Group1, Group2, Group14, ECP256, ECP384, Group24
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EncryptionMethod

仮想プライベートネットワーク (VPN) 暗号化方法を指定します。有効な値は次のとおりです。

DES
DES3
AES128
AES192
AES256

型:	VPNEncryptionMethod
指定可能な値:	DES, DES3, AES128, AES192, AES256, CBCDES, CBCDES3, AES128CBC, AES192CBC, AES256CBC, GCMAES128, GCMAES192, GCMAES256
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-GREIPv4Address

汎用ルートカプセル化 (GRE) IPv4 アドレスを指定します。

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

-GREIPv6Address

GRE IPv6 アドレスを指定します。

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

-GREKey

GRE キーを指定します。

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

-GRETunnel

このコマンドレットが GRE トンネルを使用することを示します。

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

-IntegrityCheckMethod

仮想プライベートネットワーク (VPN) の整合性チェック方法を指定します。有効な値は次のとおりです。

MD5
SHA1
SHA256
SHA384

型:	VPNIntegrityCheckMethod
指定可能な値:	MD5, SHA1, SHA256, SHA384, SHA196
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-IPAddresses

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

-IPSecIdleDisconnectSeconds

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

-IPSecMainSALifeTimeKiloBytes

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

-IPSecMainSALifeTimeSeconds

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

-IPSecQuickSALifeTimeKiloBytes

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

-IPSecQuickSALifeTimeSeconds

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

-JobVariable

ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。

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

-LocalTrafficSelectors

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

-MaximumBandwidthInboundKbps

最大受信帯域幅を kbps 単位で指定します。

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

-MaximumBandwidthOutboundKbps

最大送信帯域幅を kbps 単位で指定します。

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

-Name

VMM オブジェクトの名前を指定します。

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

-NextHopNetwork

VMNetwork オブジェクトを指定します。

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

-OnBehalfOfUser

ユーザー名を指定します。このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。

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

-OnBehalfOfUserRole

ユーザーロールを指定します。ユーザーロールを取得するには、Get-SCUserRole コマンドレットを使用します。このコマンドレットは、このパラメーターが指定するユーザーロールに代わって動作します。

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

-PeerIPAddresses

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

-PFSGroup

仮想プライベートネットワーク (VPN) Perfect Forward Secrecy (PFS) グループを指定します。有効な値は次のとおりです。

何一つ
PFS1
PFS2
PFS2048
ECP256
ECP384
PFSMM
PFS24

型:	VPNPFSGroup
指定可能な値:	None, PFS1, PFS2, PFS2048, ECP256, ECP384, PFSMM, PFS24, PFS14
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。このパラメーターを使用すると、PRO のヒントを監査できます。

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

-Protocol

VPN プロトコルを指定します。このパラメーターに使用できる値は次のとおりです。

IKEv2
L2TP
PPTP
GRE

型:	VPNProtocol
指定可能な値:	IKEv2, L2TP, PPTP, GRE, L3, IPSec
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemoteTrafficSelectors

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

-RunAsynchronously

コントロールがコマンドシェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

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

-Secret

実行アカウントを指定します。

実行アカウントを取得するには、Get-SCRunAsAccount コマンドレットを使用します。

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

-TargetIPv4VPNAddress

IPv4 形式のターゲット VPN アドレスを指定します。

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

-TargetIPv6VPNAddress

IPv6 形式のターゲット VPN アドレスを指定します。

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

-VMMServer

VMM サーバーオブジェクトを指定します。

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

-VMNetworkGateway

仮想マシンネットワークゲートウェイオブジェクトを指定します。

VMNetworkGateway オブジェクトを取得するには、Get-SCVMNetworkGateway コマンドレットを使用します。

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

次の方法で共有