Set-SCVirtualNetwork

参考

模块:: VirtualMachineManager

更改 VMM 托管的主机上配置的虚拟网络的属性。

语法

Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   [-Name <String>]
   [-Description <String>]
   [-BoundToVMHost <Boolean>]
   [-HostBoundVLanId <UInt16>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   -LogicalSwitch <LogicalSwitch>
   [-VMHostNetworkAdapters <HostNetworkAdapter[]>]
   [-Description <String>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   -LogicalSwitch <LogicalSwitch>
   [-Description <String>]
   [-JobGroup <Guid>]
   [-ConvertToLogicalSwitch]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCVirtualNetwork
   [-ClusterVirtualNetwork] <ClusterVirtualNetwork>
   [-Name <String>]
   [-Description <String>]
   [-BoundToVMHost <Boolean>]
   [-HostBoundVLanId <UInt16>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

说明

Set-SCVirtualNetwork cmdlet 更改虚拟机管理器（VMM）托管的主机上配置的虚拟网络的属性。

可以更改的虚拟网络属性包括：

任何主机。对于为 VMM 支持的任何主机上部署的虚拟机配置的虚拟网络（Hyper-V、VMware ESX 或 Citrix XenServer 主机），可以设置或修改名称或说明。
仅 Hyper-V 主机。如果主机是 Hyper-V 主机，还可以配置虚拟机是否绑定到主机（因此可以访问主机操作系统），并且可以为主机上的虚拟局域网（VLAN）指定数字标识符。

示例

示例 1：从主机取消绑定虚拟网络

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "InternalVNet01"
PS C:\> Set-SCVirtualNetwork -VirtualNetwork $VirtualNetwork -Name "UnboundVNet01" -BoundToVMHost $False

第一个命令获取名为 VMHost01 的主机对象，并将该对象存储在$VMHost变量中。

第二个命令从 VMHost01 获取名为 InternalVNet01 的虚拟网络对象，并将该对象存储在$VirtualNetwork变量中。

最后一个命令将虚拟网络重命名为 UnboundVNet01，并将 VMHostBound 设置为$False。这会解除主机的虚拟网络的绑定，从而阻止附加到此虚拟网络的任何虚拟机通过此网络访问主机。

参数

-BoundToVMHost

指示虚拟网络是否绑定到主机。将虚拟网络绑定到主机可实现与主机的网络通信。

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

-ClusterVirtualNetwork

指定群集虚拟网络对象。

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

-ConvertToLogicalSwitch

指示此 cmdlet 将虚拟网络转换为逻辑交换机。

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

-Description

指定虚拟网络的说明。

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

-HostBoundVLanId

将 VLAN 分配给为指定虚拟网络的主机创建的虚拟网络适配器。

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

-JobGroup

指定一系列命令的标识符，该命令将在包含相同作业组标识符的最终命令运行之前作为集运行。

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

-JobVariable

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

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

-LogicalSwitch

指定逻辑交换机对象。

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

-Name

指定 VMM 对象的名称。

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

-VirtualNetwork

指定虚拟网络对象。

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

-VMHostNetworkAdapters

指定一个或多个物理网络适配器对象的数组，该主机上部署的虚拟机可以连接到该主机。

示例格式：-VMHostNetworkAdapters $VMHostNICs

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

输出

VirtualNetwork

此 cmdlet 返回 VirtualNetwork 对象。

通过