Set-SCNATConnection

更新 NAT 连接。

语法

Set-SCNATConnection
   [-VMMServer <ServerConnection>]
   [-NATConnection] <NATConnection>
   [-Name <String>]
   [-Description <String>]
   [-Status <GatewayConnectionStatus>]
   [-MaximumBandwidthInboundKbps <UInt64>]
   [-MaximumBandwidthOutboundKbps <UInt64>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

说明

Set-SCNATConnection cmdlet 更新网络地址转换(NAT)连接。

示例

示例 1:更改虚拟机网络的 NAT 连接的名称和说明

PS C:\> $VmNetwork = Get-SCVMNetwork -Name "NAT_VMNetwork"
PS C:\> $NatConnection = Get-SCNATConnection -VMNetwork $VmNetwork
PS C:\> Set-SCNATConnection -NATConnection $NatConnection -Name "NatConn_VMNAT1" -Description "NAT Connection for VM Network1"

第一个命令按其名称获取虚拟机网络,并将其存储在$VmNetwork变量中。

第二个命令获取虚拟机网络的 NAT 连接,并将其存储在$NatConnection变量中。

第三个命令将 NAT 连接名称更改为NatConn_VMNAT1,并将其说明更改为 VM Network1 的 NAT 连接。

示例 2:更改虚拟机网络的 NAT 连接的状态

PS C:\> $VmNetwork = Get-SCVMNetwork -Name "NAT_VMNetwork"
PS C:\> $NatConnection = Get-SCNATConnection -VMNetwork $VmNetwork
PS C:\> Set-SCNATConnection -NATConnection  $NatConnection -Status Disabled"

第一个命令按其名称获取虚拟机网络,并将其存储在$VmNetwork变量中。

第二个命令获取虚拟机网络的 NAT 连接,并将其存储在$NatConnection变量中。

第三个命令将 NAT 连接状态更改为“已禁用”。

参数

-Description

指定 NAT 连接的说明。

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

-JobVariable

指定在其中跟踪和存储作业进度的变量。

类型:String
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

指定网络对象的名称。

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

-NATConnection

指定 NAT 连接对象。

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

-OnBehalfOfUser

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

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

-OnBehalfOfUserRole

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

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

-PROTipID

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

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

-RunAsynchronously

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

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

-Status

指定网关连接状态。 此参数的可接受值为:

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

-VMMServer

指定 Virtual Machine Manager (VMM) 服务器对象。

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