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 .