Поделиться через

Set-SCVirtualNetworkAdapter

  • Ссылка
Модуль:
VirtualMachineManager

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

Синтаксис

Set-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMMServer <ServerConnection>]
   -SlotID <Int32>
   [-VirtualNetwork <String>]
   [-RequiredBandwidth <Decimal>]
   [-NoConnection]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoLogicalNetwork]
   -JobGroup <Guid>
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-NoPortClassification]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMMServer <ServerConnection>]
   [-VirtualNetworkAdapter] <VirtualNetworkAdapter>
   [-VirtualNetwork <String>]
   [-RequiredBandwidth <Decimal>]
   [-NoConnection]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoLogicalNetwork]
   [-JobGroup <Guid>]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-NoPortClassification]
   [-IPv4Addresses <System.Collections.Generic.List`1[System.String]>]
   [-IPv6Addresses <System.Collections.Generic.List`1[System.String]>]
   [-IPv4AddressPools <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]>]
   [-IPv6AddressPools <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualNetworkAdapter
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-VMMServer <ServerConnection>]
   [[-VirtualNetworkAdapter] <VirtualNetworkAdapter>]
   -VirtualNetwork <String>
   [-Checkpoint]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Описание

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

Операции, которые можно выполнить, включают следующие:

  • Подключите адаптер виртуальной сети к виртуальной сети.

  • Отключите адаптер виртуальной сети от виртуальной сети.

  • Укажите сетевое расположение и сетевой тег на виртуальном сетевом адаптере.

  • Укажите MAC-адрес на виртуальном сетевом адаптере.

  • Включите использование виртуальной локальной сети (VLAN) и укажите идентификатор виртуальной ЛС (числовый идентификатор) для этой виртуальной локальной сети на виртуальном сетевом адаптере.

Заметка

  • Новый параметр [-PhysicalNetworkAdapterName] включен в VMM 2019 UR2 и более поздних версий. Дополнительные сведения см. в разделепараметров .
  • Новые параметры [-AllowedVLanList] и [-NativeVLanId] включены в VMM 2019 UR3 и более поздних версий. Дополнительные сведения см. в разделепараметров .

Примеры

Пример 1. Подключение виртуального сетевого адаптера к виртуальной сети

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.PhysicalAddress -eq "00:16:D3:CC:00:1B" }
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -VirtualNetwork "ExternalVirtualNetwork01"

Первая команда получает объект виртуальной машины с именем VM01 и сохраняет объект в переменной $VM.

Вторая команда получает все объекты виртуальной сети в VM01, выбирает объект адаптера с физическим (MAC) адресом 00:16:D3:CC:00:1B, а затем сохраняет объект в переменной $Adapter.

Последняя команда подключает адаптер виртуальной сети, хранящийся в $Adapter, к виртуальной сети с именем ExternalVirtualNetwork01 на узле, содержащем VM01.

Пример 2. Указание статического MAC-адреса для виртуального сетевого адаптера

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.ID -eq "5c0ee80a-731f-41c8-92f0-85a1619f9a1b" }
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -PhysicalAddressType "Static" -PhysicalAddress "00:16:D3:CC:00:1C"

Первая команда получает объект виртуальной машины с именем VM02 и сохраняет объект в переменной $VM.

Вторая команда получает все объекты адаптера виртуальной сети на vm02, выбирает адаптер виртуальной сети с указанным идентификатором, а затем сохраняет объект в переменной $Adapter. В этом примере предполагается, что этот адаптер в настоящее время имеет динамический MAC-адрес.

Последняя команда указывает, что адаптер виртуальной сети, хранящийся в $Adapter, использует статический MAC-адрес 00:16:D3:CC:00:1C.

Пример 3. Укажите статический MAC-адрес и назначьте его существующему сетевому адаптеру.

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter (Get-VirtualNetworkAdapter -VM $VM | where { $_.ID -eq "95e9cfda-861c-44a3-b2ba-2f796dfe691c"}) -MACAddressType "Static" -MACAddress "00-00-00-00-00-00"

Первая команда получает объект виртуальной машины с именем VM03 и сохраняет объект в переменной $VM.

Вторая команда получает объект виртуального сетевого адаптера на vm03 по идентификатору, указывает, что адаптер использует статический тип MAC-адреса и назначает его MAC-адрес.

Пример 4. Отключение указанного виртуального сетевого адаптера из виртуальной сети

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapters[1] -NoConnection

Первая команда получает объект виртуальной машины с именем VM04 и сохраняет объект в переменной $VM.

Вторая команда получает все объекты адаптера виртуальной сети на vm04 и сохраняет объекты адаптера в $Adapters. В этом примере предполагается, что vm04 имеет по крайней мере два виртуальных сетевых адаптера.

Последняя команда использует параметр NoConnection для отключения второго виртуального сетевого адаптера (Адаптеры[1]) от любой виртуальной сети, к которой он подключен.

Пример 5. Указание группы портов VMware для существующей виртуальной машины

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapter = $VM.VirtualNetworkAdapters[0]
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -VMwarePortGroup "VM Network"

Первая команда получает объект виртуальной машины с именем VM05 и сохраняет объект в переменной $VM.

Вторая команда сохраняет первый сетевой адаптер [0] на VM05 в переменной $Adapter.

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

Параметры

-AdapterFlags

{{Fill AdapterFlags Description}}

Тип:VirtualNetworkAdapterFlags
Допустимые значения:None, ApplyInfrastructurePortProfileForNetworkController, ApplyNCPortProfileForNetworkController, ApplyInstaceIDPortProfileForNetworkController
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AllowedVLanList

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

Заметка

Этот параметр применим для VMM 2019 UR3 и более поздних версий.

Тип:UInt16
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Checkpoint

Указывает, чтобы использовать разрешение "Может контрольная точка".

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DevicePropertiesAdapterName

Указывает имя сетевого адаптера.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DevicePropertiesAdapterNameMode

Задает режим имени адаптера.

Тип:DevicePropertiesAdapterNameMode
Допустимые значения:Disabled, VMNetwork, Custom
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableGuestIPNetworkVirtualizationUpdates

Указывает, включено ли обновление виртуализации IP-сети гостевым гостем.

Тип:Boolean
Aliases:GuestIPNetworkVirtualizationUpdatesEnabled
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableMACAddressSpoofing

Включает, если задано значение $True, mac-адрес спуфингов.

Тип:Boolean
Aliases:MACAddressesSpoofingEnabled
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableVMNetworkOptimization

Включает, если задано значение $True, оптимизация сети виртуальных машин.

Эта функция повышает производительность сети для виртуальных машин с сетевыми адаптерами, поддерживающими загрузку очереди виртуальных машин (VMQ) или TCP Chimney Offload. VMQ позволяет создавать уникальную сетевую очередь для каждого виртуального сетевого адаптера. Разгрузка TCP Chimney позволяет выгрузить сетевой трафик из сетевого стека.

Тип:Boolean
Aliases:VMNetworkOptimizationEnabled
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IPv4Addresses

Указывает список IPv4-адресов.

Тип:System.Collections.Generic.List`1[System.String]
Aliases:IPv4Address
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IPv4AddressPools

Указывает список пулов адресов IPv4.

Тип:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]
Aliases:IPv4AddressPool
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IPv4AddressType

Указывает тип адреса IPv4. Допустимые значения для этого параметра:

  • Динамический
  • Статический
Тип:EthernetAddressType
Допустимые значения:Dynamic, Static
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IPv6Addresses

Указывает список IPv6-адресов.

Тип:System.Collections.Generic.List`1[System.String]
Aliases:IPv6Address
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IPv6AddressPools

Указывает список пулов адресов IPv6.

Тип:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]
Aliases:IPv6AddressPool
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-IPv6AddressType

Указывает тип адреса IPv6. Допустимые значения для этого параметра:

  • Динамический
  • Статический
Тип:EthernetAddressType
Допустимые значения:Dynamic, Static
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-JobGroup

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

Тип:Guid
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-JobVariable

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LogicalNetwork

Указывает логическую сеть. Логическая сеть — это именованное группирование IP-подсетей и виртуальных ЛС, используемых для упорядочивания и упрощения сетевых назначений.

Тип:LogicalNetwork
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MACAddress

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

  • Пример формата для одного MAC-адреса: -MACAddress "00-15-5D-B4-DC-00"
  • Пример формата для набора MAC-адресов: -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"
Тип:String
Aliases:EthernetAddress, PhysicalAddress
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-MACAddressType

Указывает тип MAC-адреса, используемого для виртуального сетевого адаптера. Допустимые значения: статические, динамические.

Тип:String
Aliases:EthernetAddressType, PhysicalAddressType
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NativeVLanId

Задает собственный идентификатор виртуальной локальной сети для сетевого адаптера виртуальной машины.

Заметка

Этот параметр применим для VMM 2019 UR3 и более поздних версий.

Тип:UInt16
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NetworkLocation

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

Примеры форматов:

  • -NetworkLocation $NetLoc ($NetLoc может содержать Corp.Contoso.com)
  • -OverrideNetworkLocation $True -NetworkLocation "HostNICNewLocation.Contoso.com"
Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NetworkTag

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

Параметр NetworkTag определяет все виртуальные машины с теми же NetworkTag, что и члены одной сети. VMM использует NeworkTag (если он существует), если он оценивает узлы как возможные кандидаты, на которых развертывается виртуальная машина. Если узел не включает виртуальные машины в сеть с той же NetworkTag, что и виртуальная машина, узел получает нулевые звезды в процессе размещения.

Тип:String
Aliases:Tag
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NoConnection

Отключает адаптер виртуальной сети от виртуальной сети.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NoLogicalNetwork

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

Тип:SwitchParameter
Aliases:NoVMNetwork
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NoPortClassification

Указывает, что классификация портов не предоставляется.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OnBehalfOfUser

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OnBehalfOfUserRole

Указывает роль пользователя. Чтобы получить роль пользователя, используйте командлет Get-SCUserRole . Этот командлет работает от имени роли пользователя, указанной этим параметром.

Тип:UserRole
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PhysicalNetworkAdapterName

Указывает имя физического сетевого адаптера.

Заметка

Этот параметр применим для VMM 2019 UR2 и более поздних версий.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PortACL

Указывает объект ACL порта.

Тип:PortACL
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PortClassification

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

Тип:PortClassification
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PROTipID

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

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemovePortACL

Указывает, что эта операция удаляет список управления доступом портов (ACL).

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RequiredBandwidth

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

Тип:Decimal
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RunAsynchronously

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SlotID

Задает числовый идентификатор, используемый для идентификации устройства.

Тип:Int32
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VirtualNetwork

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

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VirtualNetworkAdapter

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

Типы узлов поддерживают следующее число виртуальных сетевых адаптеров:

  • Hyper-V. До четырех эмулированных адаптеров на каждую виртуальную машину. Драйвер недоступен для эмулированного сетевого адаптера в гостевой операционной системе Windows Server 2003 x64.

  • Hyper-V. До восьми синтетических адаптеров на каждую виртуальную машину.

  • VMware ESX. До четырех эмулированных адаптеров на каждую виртуальную машину.

  • Citrix XenServer. До семи эмулированных адаптеров на каждую виртуальную машину.

Тип:VirtualNetworkAdapter
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-VLanEnabled

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

  • Пример: -VLANEnabled -VLANID 35
Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VLanID

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

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

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

Тип:UInt16
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VMMServer

Указывает объект сервера VMM.

Тип:ServerConnection
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-VMNetwork

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

Чтобы получить сетевой объект виртуальной машины, используйте командлет Get-SCVMNetwork.

Тип:VMNetwork
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VMNetworkServiceSetting

Задает параметр сетевой службы виртуальной машины.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VMSubnet

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

Чтобы получить объект VMSubnet, используйте командлет Get-SCVMSubnet.

Тип:VMSubnet
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VMwarePortGroup

Указывает группу портов VMware.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

VirtualNetworkAdapter

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

Примечания

  • Требуется объект виртуального сетевого адаптера VMM, который можно получить с помощью командлета Get-SCVirtualNetworkAdapter.