Set-SCVirtualNetwork

Модуль:
VirtualMachineManager Module

Изменяет свойства виртуальной сети, настроенной на узле, управляемом VMM.

Синтаксис

Host (по умолчанию) 

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

LogicalSwitch 

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

StandardSwitchToLogicalSwitch 

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

Cluster 

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

Описание

Командлет Set-SCVirtualNetwork изменяет свойства виртуальной сети, настроенной на узле, управляемом диспетчером виртуальных машин (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

Первая команда получает объект host с именем VMHost01 и сохраняет объект в переменной $VMHost.

Вторая команда получает объект виртуальной сети с именем InternalVNet01 из VMHost01 и сохраняет объект в переменной $VirtualNetwork.

Последняя команда переименовывает виртуальную сеть в UnboundVNet01 и задает для VMHostBound значение $False. При этом виртуальная сеть отвязывается от узла, что предотвращает доступ виртуальных машин, подключенных к этой виртуальной сети, к узлу через эту сеть.

Параметры

-BoundToVMHost

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

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Host
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
Cluster
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ClusterVirtualNetwork

Указывает объект виртуальной сети кластера.

Свойства параметра

Тип:ClusterVirtualNetwork
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Cluster
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ConvertToLogicalSwitch

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

StandardSwitchToLogicalSwitch
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Description

Указывает описание виртуальной сети.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-HostBoundVLanId

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

Свойства параметра

Тип:UInt16
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Host
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
Cluster
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-JobGroup

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

Свойства параметра

Тип:Guid
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-JobVariable

Указывает, что ход выполнения задания отслеживается и хранится в переменной с именем этого параметра.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-LogicalSwitch

Указывает объект логического переключателя.

Свойства параметра

Тип:LogicalSwitch
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

LogicalSwitch
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

Указывает имя объекта VMM.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Host
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
Cluster
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PROTipID

Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проверять советы PRO.

Свойства параметра

Тип:Guid
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RunAsynchronously

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VirtualNetwork

Указывает объект виртуальной сети.

Свойства параметра

Тип:VirtualNetwork
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Host
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
LogicalSwitch
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMHostNetworkAdapters

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

Пример формата: -VMHostNetworkAdapters $VMHostNICs

Свойства параметра

Тип:

HostNetworkAdapter[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

LogicalSwitch
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Выходные данные

VirtualNetwork

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