Поделиться через


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 изменяет свойства виртуальной сети, настроенной на узле под управлением 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.

Вторая команда получает объект виртуальной сети с именем InternalVNet01 из VMHost01 и сохраняет объект в переменной $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

Указывает, что этот командлет преобразует виртуальную сеть в логический коммутатор.

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

Назначает виртуальную локальную сеть виртуальной сетевой адаптеру, созданному для узла для указанной виртуальной сети.

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), активировав это действие. Этот параметр позволяет проводить аудит советов PRO.

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

-RunAsynchronously

Указывает, что задание выполняется асинхронно, чтобы управление немедленно возвращалось в командную оболочку.

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

Этот командлет возвращает объект VirtualNetwork .