Set-SCVMHostNetworkAdapter

Изменяет сетевые свойства физического сетевого адаптера на узле, управляемом VMM.

Синтаксис

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

Set-SCVMHostNetworkAdapter
    [-VMHostNetworkAdapter] <HostNetworkAdapter>
    [-Description <String>]
    [-VLanMode <VlanMode>]
    [-AvailableForPlacement <Boolean>]
    [-UsedForManagement <Boolean>]
    [-SubnetVLan <SubnetVLan[]>]
    [-RemoveUnassignedVLan <UInt16[]>]
    [-AddOrSetLogicalNetwork <LogicalNetwork>]
    [-RemoveLogicalNetwork <LogicalNetwork>]
    [-EnableNetworkVirtualization <Boolean>]
    [-UplinkPortProfileSet <UplinkPortProfileSet>]
    [-RemoveUplinkPortProfileSet]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Manual

Set-SCVMHostNetworkAdapter
    [-VMHostNetworkAdapter] <HostNetworkAdapter>
    [-Description <String>]
    [-VLanEnabled <Boolean>]
    [-VLanMode <VlanMode>]
    [-VLanID <UInt16>]
    [-VLanTrunkID <UInt16[]>]
    [-AvailableForPlacement <Boolean>]
    [-UsedForManagement <Boolean>]
    [-RemoveUnassignedVLan <UInt16[]>]
    [-EnableNetworkVirtualization <Boolean>]
    [-UplinkPortProfileSet <UplinkPortProfileSet>]
    [-RemoveUplinkPortProfileSet]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Описание

Командлет Set-SCVMHostNetworkAdapter изменяет сетевые свойства физического сетевого адаптера на узле, управляемом диспетчером виртуальных машин (VMM).

С помощью этого командлета можно изменить следующие свойства:

  • Настройки VLAN: Вы можете использовать параметры VLAN для создания или изменения одной или нескольких VLAN. Иллюстрацию того, как указать параметры VLAN, см. в примерах.

Для получения дополнительной информации о сетях VLAN и дополнительных примеров, иллюстрирующих параметры сети VLAN, введите Get-Help Add-SCVMHostNetworkAdapter -Detailed.

Примеры

Пример 1: Создание новой виртуальной сети на сетевом адаптере узла и указание идентификатора VLAN для виртуальной сети

PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost02.Contoso.com"
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost |  where {$_.Name -like "Intel(R) PRO/1000*" }
PS C:\> New-SCVirtualNetwork -Name "VirtualNetwork01" -VMHost $VMHost -VMHostNetworkAdapter $HostAdapter
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $HostAdapter -VLanEnabled $True -VLanMode "Access" -VLANID 35

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

Вторая команда получает объект сетевого адаптера хоста с именем, которое начинается с "Intel(R) PRO/1000 на VMHost02", и сохраняет объект в переменной $HostAdapter.

Третья команда создает виртуальную сеть с именем VirtualNetwork01 на VMHost02, которая привязана к адаптеру узла, хранящемуся в $HostAdapter.

Последняя команда включает VLAN, устанавливает режим Access (который направляет трафик внутри одной VLAN) и назначает сетевому адаптеру VLANID, равный 35.

Примечание: В этом примере предполагается, что ваш хост уже подключен к VLAN или, если нет, что ваш хост имеет два сетевых адаптера. Если узел имеет один сетевой адаптер, назначение адаптера виртуальной локальной сети, недоступной для сервера VMM, не позволит VMM управлять узлом.

Пример 2: Добавление тегов VLan к сетевому адаптеру хоста, настроенному в режиме магистрали

PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost03.Contoso.com"
PS C:\> $VMHostNIC = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "Adapter #3"
PS C:\> $NewVlanTags = $VMHostNIC.VlanTags + @(177,355,1012)
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $VMHostNIC -VLANEnabled $TRUE -VLanMode "Trunk" -VLanTrunkID $NewVLanTags

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

Вторая команда получает объект сетевого адаптера узла, указав имя адаптера, и сохраняет объект в переменной $VMHostNIC.

Третья команда использует свойство VlanTags объекта сетевого адаптера узла ($VMHostNIC.VlanTags) и объединяет новый массив тегов. Обновленный массив сохраняет существующие VlanTags и добавляет перечисленные теги в массив. Результат конкатенации сохраняется в $NewVlanTags.

Последняя команда передает новый список тегов VLAN в параметр VLANTrunkID команды Set-VMHostNetworkAdapter. Параметр VLANMode должен указывать значение "Trunk" всякий раз, когда параметр VLANTrunkID используется для изменения списка числовых идентификаторов магистрали VLAN.

Параметры

-AddOrSetLogicalNetwork

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

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

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

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

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

-AvailableForPlacement

Указывает, считает ли процесс размещения VMM этот узел или этот том на узле подходящим в качестве возможного расположения для развертывания виртуальных машин. Если для этого параметра задано значение $False, вы в любом случае можете выбрать развертывание виртуальных машин на этом узле или томе. Значение по умолчанию — $True. Этот параметр не применяется к узлам VMware ESX.

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

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

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

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

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

-Description

Указывает описание для указанного объекта.

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

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

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

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

-EnableNetworkVirtualization

Указывает, включена ли виртуализация сети. Значение по умолчанию — $False.

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

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

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

(All)
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

-PROTipID

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

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

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

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

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

-RemoveLogicalNetwork

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

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

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

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

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

-RemoveUnassignedVLan

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

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

Тип:

UInt16[]

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

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

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

-RemoveUplinkPortProfileSet

Удаляет набор профилей порта восходящей связи с адаптером сети узла.

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

Тип:SwitchParameter
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

-SubnetVLan

Указывает одну или несколько наборов IP-подсетей и VLAN.

Для получения сведений о создании подсетиVLan введите Get-Help New-SCSubNetVLan.

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

Тип:

SubnetVLan[]

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

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

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

-UplinkPortProfileSet

Указывает объект набора профилей порта восходящей связи.

Чтобы получить объект набора профилей порта восходящей связи, используйте командлет Get-SCUplinkPortProfileSet .

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

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

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

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

-UsedForManagement

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

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

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

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

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

-VLanEnabled

Включает виртуальную локальную сеть (VLAN) для использования виртуальными машинами на хосте Hyper-V или Citrix XenServer.

  • Пример формата для одной VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35
  • Пример формата для нескольких VLAN: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

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

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

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

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

-VLanID

Назначает числовой идентификатор в диапазоне 1-4094 виртуальному сетевому адаптеру на виртуальной машине или физическому сетевому адаптеру на узле виртуальной машины.

Настройте VLanID на узле Hyper-V, VMware ESX или Citrix XenServer:

  • На внешнем физическом сетевом адаптере, когда для VLan выбран режим Access.

Настройте VLanID на виртуальном сетевом адаптере виртуальной машины:

  • Привязаны к физическому сетевому адаптеру на хосте или
  • Привязка к внутренней виртуальной сети на узле.

Пример формата: -VLanEnabled -VLanMode "Access" -VLANID 35

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

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

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

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

-VLanMode

Указывает, поддерживает ли виртуальная локальная сеть (VLAN) на узле виртуальной машины трафик через одну VLAN (режим доступа) или через несколько VLAN (режим магистрали). Допустимые значения: Access, Trunk.

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

Тип:VlanMode
Default value:None
Допустимые значения:Access, Trunk, Invalid
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-VLanTrunkID

Назначает список числовых идентификаторов в диапазоне 1-4094 физическому сетевому адаптеру на Hyper-V узле.

Пример формата: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

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

Тип:

UInt16[]

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

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

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

-VMHostNetworkAdapter

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

Пример формата: -VMHostNetworkAdapter $VMHostNIC

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

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

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

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

CommonParameters

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

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

VMHostNetworkAdapter

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