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


Set-SCVirtualNetworkAdapter

Изменяет свойства виртуального сетевого адаптера, связанного с виртуальной машиной, шаблоном виртуальной машины или профилем оборудования, используемым для создания виртуальных машин в 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}}

Type:VirtualNetworkAdapterFlags
Accepted values:None, ApplyInfrastructurePortProfileForNetworkController, ApplyNCPortProfileForNetworkController, ApplyInstaceIDPortProfileForNetworkController
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowedVLanList

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

Примечание

Этот параметр применим к VMM 2019 UR3.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Checkpoint

Указывает на использование разрешения Can Checkpoint.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DevicePropertiesAdapterName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DevicePropertiesAdapterNameMode

Указывает режим имени адаптера.

Type:DevicePropertiesAdapterNameMode
Accepted values:Disabled, VMNetwork, Custom
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableGuestIPNetworkVirtualizationUpdates

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

Type:Boolean
Aliases:GuestIPNetworkVirtualizationUpdatesEnabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableMACAddressSpoofing

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

Type:Boolean
Aliases:MACAddressesSpoofingEnabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableVMNetworkOptimization

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

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

Type:Boolean
Aliases:VMNetworkOptimizationEnabled
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv4Addresses

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

Type:System.Collections.Generic.List`1[System.String]
Aliases:IPv4Address
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv4AddressPools

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

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]
Aliases:IPv4AddressPool
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv4AddressType

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

  • Динамический
  • Статические
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6Addresses

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

Type:System.Collections.Generic.List`1[System.String]
Aliases:IPv6Address
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6AddressPools

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

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]
Aliases:IPv6AddressPool
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6AddressType

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

  • Динамический
  • Статические
Type:EthernetAddressType
Accepted values:Dynamic, Static
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobGroup

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

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogicalNetwork

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

Type:LogicalNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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"
Type:String
Aliases:EthernetAddress, PhysicalAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MACAddressType

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

Type:String
Aliases:EthernetAddressType, PhysicalAddressType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NativeVLanId

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

Примечание

Этот параметр применим к VMM 2019 UR3.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NetworkLocation

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

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

  • -NetworkLocation $NetLoc ($NetLoc может содержать Corp.Contoso.com)
  • -OverrideNetworkLocation $True -NetworkLocation "HostNICNewLocation.Contoso.com"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NetworkTag

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

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

Type:String
Aliases:Tag
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoConnection

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoLogicalNetwork

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

Type:SwitchParameter
Aliases:NoVMNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoPortClassification

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

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

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PhysicalNetworkAdapterName

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

Примечание

Этот параметр применим для VMM 2019 UR2.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PortACL

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

Type:PortACL
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PortClassification

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

Type:PortClassification
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemovePortACL

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiredBandwidth

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

Type:Decimal
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SlotID

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

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNetwork

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNetworkAdapter

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

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

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

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

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

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

Type:VirtualNetworkAdapter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VLanEnabled

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

  • Например, -VLANEnabled -VLANID 35.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanID

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

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

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

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

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

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMNetwork

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

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

Type:VMNetwork
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMNetworkServiceSetting

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMSubnet

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

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

Type:VMSubnet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMwarePortGroup

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

VirtualNetworkAdapter

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

Примечания

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