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 对象。