Set-SCVirtualNetwork

更改 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 更改由 Virtual Machine Manager (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

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClusterVirtualNetwork

指定群集虚拟网络对象。

Type:ClusterVirtualNetwork
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ConvertToLogicalSwitch

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

指定虚拟网络的说明。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HostBoundVLanId

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

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobGroup

在运行最后一个包含相同作业组标识符的命令之前,为作为集合运行的一系列命令指定标识符。

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogicalSwitch

指定逻辑交换机对象。

Type:LogicalSwitch
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

指定 VMM 对象的名称。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNetwork

指定虚拟网络对象。

Type:VirtualNetwork
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHostNetworkAdapters

指定主机上的一个或一组物理网络适配器对象,在此主机上部署的虚拟机可以连接到这些对象。

示例格式: -VMHostNetworkAdapters $VMHostNICs

Type:HostNetworkAdapter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

输出

VirtualNetwork

此 cmdlet 返回 VirtualNetwork 对象。