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) и укажите идентификатор виртуальной ЛС (числовой идентификатор) для этой виртуальной локальной сети на виртуальном сетевом адаптере.
Примечание
Примеры
Пример 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 .