Add-SCVMHostNetworkAdapter
Добавляет физический сетевой адаптер на узел, управляемый VMM, в виртуальную сеть.
Синтаксис
Default (по умолчанию)
Add-SCVMHostNetworkAdapter
-VirtualNetwork <VirtualNetwork>
[-VLanEnabled]
[-VLanMode <VlanMode>]
[-VLanID <UInt16>]
[-VLanTrunkID <UInt16[]>]
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Описание
Командлет Add-SCVMHostNetworkAdapter добавляет физический сетевой адаптер (также называемый сетевой картой) на узел, управляемый диспетчером виртуальных машин (VMM), в виртуальную сеть. Каждая виртуальная машина на этом узле также может подключаться к этой виртуальной сети через виртуальный сетевой адаптер.
Виртуальная сеть, настроенная на узле, может подключаться к нескольким виртуальным сетевым адаптерам на виртуальных машинах, развернутых на этом узле.
VMM для System Center 2019 и более поздних версий включает поддержку виртуальных сетей для настройки одной или нескольких виртуальных локальных сетей (VLAN) на узле. Для настройки одной или нескольких сетей VLAN на узле можно использовать командлет Add-SCVMHostNetworkAdapter или командлет Set-SCVMHostNetworkAdapter . Чтобы настроить соответствующие параметры VLAN на виртуальной машине, используйте командлет New-SCVirtualNetworkAdapter или командлет Set-SCVirtualNetworkAdapter .
Иллюстрацию каждого типа VLAN см. в примерах для этого командлета.
Примеры
Пример 1: Добавление физического сетевого адаптера узла в виртуальную сеть
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork01"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter01"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter
Первая команда получает объект host с именем VMHost01 и сохраняет объект в переменной $VMHost.
Вторая команда получает объект виртуальной сети с именем ExternalVirtualNetwork01 на VMHost01 и сохраняет объект в переменной $VirtualNetwork.
Третья команда получает физический объект сетевого адаптера с именем HostAdapter01 на VMHost01 и сохраняет объект в переменной $VMHostNetworkAdapter.
Последняя команда добавляет HostAdapter01 к ExternalVirtualNetwork01.
Примечание: Вы можете добавить только один физический адаптер хоста для каждой виртуальной сети. Таким образом, последняя команда завершится ошибкой, если адаптер уже связан с указанной виртуальной сетью. Чтобы добавить новый адаптер в виртуальную сеть, необходимо сначала удалить существующий адаптер узла.
Пример 2: Добавление физического сетевого адаптера хоста в VLAN, использующую режим "Trunk"
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalNetwork02"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter02"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Первая команда получает объект host с именем VMHost02 и сохраняет объект в переменной $VMHost.
Вторая команда получает объект виртуальной сети с именем ExternalNetwork02 на VMHost02 и сохраняет объект в переменной $VirtualNetwork.
Третья команда получает объект сетевого адаптера с именем HostAdapter02 на VMHost02 и сохраняет объект адаптера в переменной $VMHostNetworkAdapter.
Последняя команда добавляет HostAdapter02 в виртуальную сеть ExternalNetwork02 и разрешает доступ из ExternalNetwork02 к внешнему сетевому устройству с помощью виртуальных локальных сетей 1, 2, 100, 200 и 1124 с тегами 802.1Q.
Примечание: Вы можете добавить только один хост-адаптер для каждой виртуальной сети, поэтому последняя команда завершится ошибкой, если адаптер уже связан с указанной виртуальной сетью.
Пример 3: Добавление физического сетевого адаптера хоста в VLAN, использующую режим "Access"
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork03"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter03"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLanEnabled -VLanMode "Access" -VLanID 22
Первая команда получает объект host с именем VMHost03 и сохраняет объект в переменной $VMHost.
Вторая команда получает объект виртуальной сети с именем ExternalNetwork03 на VMHost03 и сохраняет объект в переменной $VirtualNetwork.
Третья команда получает объект сетевого адаптера с именем HostAdapter03 на VMHost03 и сохраняет объект адаптера в переменной $VMHostNetworkAdapter.
Последняя команда добавляет HostAdapter03 в виртуальную сеть ExternalNetwork03 и ограничивает доступ к ExternalNetwork03 до VLANID 22.
Примечание: Вы можете добавить только один хост-адаптер для каждой виртуальной сети, поэтому последняя команда завершится ошибкой, если адаптер уже связан с указанной виртуальной сетью.
Внимание: В этом примере предполагается, что хост уже подключен к VLAN, или, если нет, убедитесь, что хост имеет два сетевых адаптера. Если узел имеет один сетевой адаптер, назначение адаптера виртуальной локальной сети, недоступной для сервера VMM, не позволит VMM управлять узлом. Действия, описанные в этом примере, можно выполнить на узле с одним сетевым адаптером, если сначала установить адаптер замыкания на себя (Майкрософт) на сервере.
Параметры
-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 |
-RunAsynchronously
Указывает, что задание выполняется асинхронно, чтобы элемент управления сразу же возвращал командную оболочку.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-VirtualNetwork
Указывает объект виртуальной сети.
Свойства параметра
| Тип: | VirtualNetwork |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-VLanEnabled
Включает виртуальную локальную сеть (VLAN) для использования виртуальными машинами на хосте Hyper-V или Citrix XenServer.
Пример формата для одной VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35 Пример формата для нескольких VLAN: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| 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 |
Наборы параметров
(All)
| 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 |
Наборы параметров
(All)
| 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 .