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 .