Set-SCVPNConnection

模块:

VirtualMachineManager

设置 VPN 连接的属性。

语法

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

Set-SCVPNConnection
   [-VMMServer <ServerConnection>]
   [-VPNConnection] <VPNConnection>
   [-NextHopNetwork <VMNetwork>]
   [-Name <String>]
   [-Description <String>]
   [-Status <GatewayConnectionStatus>]
   [-MaximumBandwidthInboundKbps <UInt64>]
   [-MaximumBandwidthOutboundKbps <UInt64>]
   [-RemoveMaximumBandwidthInbound]
   [-RemoveMaximumBandwidthOutbound]
   [-IPAddresses <String[]>]
   [-PeerIPAddresses <String[]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Set-SCVPNConnection
   [-VMMServer <ServerConnection>]
   [-VPNConnection] <VPNConnection>
   [-Name <String>]
   [-Description <String>]
   [-TargetIPv4VPNAddress <String>]
   [-TargetIPv6VPNAddress <String>]
   [-Status <GatewayConnectionStatus>]
   [-MaximumBandwidthInboundKbps <UInt64>]
   [-MaximumBandwidthOutboundKbps <UInt64>]
   [-RemoveMaximumBandwidthInbound]
   [-RemoveMaximumBandwidthOutbound]
   [-GRETunnel]
   [-GREKey <UInt32>]
   [-GREIPv4Address <String>]
   [-GREIPv6Address <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

说明

Set-SCVPNConnection cmdlet 更新虚拟专用网络（VPN）连接的属性。

示例

示例 1：修改 VPN 连接

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

第一个命令获取名为 VMGateway01 的网络网关，然后将其存储在$VmNetworkGateway变量中。

第二个命令在网关上获取 $VmNetworkGateway 中的 VPN 连接，然后将其存储在$VPNConnection变量中。

第三个命令获取运行方式帐户，然后将其存储在$RunAsAccount变量中。 此帐户用于修改 VPN 连接。

最后一个命令修改$VPNConnection中的 VPN 连接。 它为多个参数指定新值。

参数

-AuthenticationMethod

指定虚拟专用网络（VPN）身份验证方法。 有效值为：PSKOnly、MachineCertificates。

类型:	VPNAuthenticationMethod
接受的值:	PSKOnly, MachineCertificates
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AuthenticationTransformConstants

指定虚拟专用网络 （VPN） 转换常量。 有效值为：

• SHA256128
• MD596
• SHA196
• GCMAES128
• GCMAES192
• GCMAES256

类型:	VPNAuthenticationTransformConstants
接受的值:	SHA256128, MD596, SHA196, GCMAES128, GCMAES192, GCMAES256, SHA256, None
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Certificate

指定安全证书对象。

类型:	ClientCertificate
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CipherTransformConstants

指定虚拟专用网络密码转换常量。 有效值为：

• DES
• DES3
• AES128
• AES192
• AES256
• GCMAES128
• GCMAES192
• GCMAES256

类型:	VPNCipherTransformConstants
接受的值:	DES, DES3, AES128, AES192, AES256, GCMAES128, GCMAES192, GCMAES256, None
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Description

指定 VPN 连接的说明。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DHGroup

指定虚拟专用网络（VPN）Diffie-Hellman（DH）组。 有效值为：

• 没有
• Group1
• Group2
• Group14
• ECP256
• ECP384
• Group24

类型:	VPNDHGroup
接受的值:	None, Group1, Group2, Group14, ECP256, ECP384, Group24
Position:	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
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-GREIPv4Address

指定通用路由封装 （GRE） IPv4 地址。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-GREIPv6Address

指定 GRE IPv6 地址。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-GREKey

指定 GRE 键。

类型:	UInt32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-GRETunnel

指示此 cmdlet 使用 GRE 隧道。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-IntegrityCheckMethod

指定虚拟专用网络（VPN）完整性检查方法。 有效值为：

• MD5
• SHA1
• SHA256
• SHA384

类型:	VPNIntegrityCheckMethod
接受的值:	MD5, SHA1, SHA256, SHA384, SHA196
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IPAddresses

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IPSecIdleDisconnectSeconds

类型:	UInt32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IPSecMainSALifeTimeKiloBytes

类型:	UInt32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IPSecMainSALifeTimeSeconds

类型:	UInt32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IPSecQuickSALifeTimeKiloBytes

类型:	UInt32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IPSecQuickSALifeTimeSeconds

类型:	UInt32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-JobVariable

指定在此参数命名的变量中跟踪和存储作业进度。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LocalTrafficSelectors

类型:	TrafficSelector[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MaximumBandwidthInboundKbps

以 kbps 为单位指定最大入站带宽。

类型:	UInt64
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MaximumBandwidthOutboundKbps

指定最大出站带宽（以 kbps 为单位）。

类型:	UInt64
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定 VMM 对象的名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NextHopNetwork

指定 VMNetwork 对象。

类型:	VMNetwork
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OnBehalfOfUser

指定用户名。 此 cmdlet 代表此参数指定的用户运行。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OnBehalfOfUserRole

指定用户角色。 若要获取用户角色，请使用 Get-SCUserRole cmdlet。 此 cmdlet 代表此参数指定的用户角色运行。

类型:	UserRole
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PeerIPAddresses

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PFSGroup

指定虚拟专用网络 （VPN） 完美转发保密 （PFS） 组。 有效值为：

• 没有
• PFS1
• PFS2
• PFS2048
• ECP256
• ECP384
• PFSMM
• PFS24

类型:	VPNPFSGroup
接受的值:	None, PFS1, PFS2, PFS2048, ECP256, ECP384, PFSMM, PFS24, PFS14
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PROTipID

指定触发此操作的性能和资源优化提示（PRO 提示）的 ID。 此参数允许你审核 PRO 提示。

类型:	Guid
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoteTrafficSelectors

类型:	TrafficSelector[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveLocalTrafficSelectors

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveMaximumBandwidthInbound

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveMaximumBandwidthOutbound

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RemoveRemoteTrafficSelectors

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RunAsynchronously

指示作业以异步方式运行，以便控件立即返回到命令行界面。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Secret

指定运行方式帐户。

若要获取运行方式帐户，请使用 Get-SCRunAsAccount cmdlet。

类型:	RunAsAccount
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Status

类型:	GatewayConnectionStatus
接受的值:	Error, Enabled, Disabled
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TargetIPv4VPNAddress

以 IPv4 格式指定目标 VPN 地址。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TargetIPv6VPNAddress

以 IPv6 格式指定目标 VPN 地址。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VMMServer

指定 VMM 服务器对象。

类型:	ServerConnection
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-VPNConnection

指定虚拟专用网络（VPN）连接对象。

若要获取 VPN 连接对象，请使用 Get-SCVPNConnection cmdlet。

类型:	VPNConnection
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

相关链接

• Add-SCVPNConnection
• Get-SCVPNConnection
• Read-SCVPNConnection
• Remove-SCVPNConnection