Remove-SCVirtualNetworkAdapter
Удаляет объект виртуального сетевого адаптера из VMM.
Синтаксис
VirtualNicSpecified
Remove-SCVirtualNetworkAdapter
[-VirtualNetworkAdapter] <VirtualNetworkAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
SlotIdSpecified
Remove-SCVirtualNetworkAdapter
-SlotID <Int32>
-JobGroup <Guid>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Описание
Командлет Remove-SCVirtualNetworkAdapter удаляет один или несколько объектов виртуального сетевого адаптера из виртуальной машины, шаблона виртуальной машины или профиля оборудования, используемого в среде диспетчера виртуальных машин (VMM).
Этот командлет возвращает объект при успешном выполнении (со свойством MarkedForDeletion, имеющим значение $True) или возвращает сообщение об ошибке при сбое.
Примеры
Пример 1: Удаление виртуального сетевого адаптера с указанным MAC-адресом из виртуальной машины
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:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter
Первая команда получает объект виртуальной машины с именем VM01 и сохраняет объект в переменной $VM.
Вторая команда получает объект виртуального сетевого адаптера на VM01 с указанным MAC-адресом и сохраняет объект в переменной $Adapter.
Последняя команда удаляет виртуальный сетевой адаптер, хранящийся в $Adapter, из VM01.
Пример 2: Удаление виртуального сетевого адаптера, подключенного к определенной виртуальной сети, с виртуальной машины
PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.VirtualNetwork -eq "ExternalVirtualNetwork01" }
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter
Первая команда получает объект виртуальной машины с именем VM02 и сохраняет объект в переменной $VM.
Вторая команда получает объект виртуального сетевого адаптера на VM02, который подключен к указанной виртуальной сети, и сохраняет объект в переменной $Adapter.
Последняя команда удаляет объект виртуального сетевого адаптера, хранящийся в $Adapter из VM02.
Пример 3: Удаление единственного виртуального сетевого адаптера с виртуальной машины
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter
Первая команда получает объект виртуальной машины с именем VM03 и сохраняет объект в переменной $VM.
Вторая команда получает объект виртуального сетевого адаптера на VM03 и сохраняет объект в переменной $Adapter. В этом примере предполагается, что VM03 имеет только один виртуальный сетевой адаптер.
Последняя команда удаляет объект виртуального сетевого адаптера, хранящийся в $Adapter, из VM03.
Пример 4: Удаление всех виртуальных сетевых адаптеров с виртуальной машины
PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters | Remove-SCVirtualNetworkAdapter
Первая команда получает объект виртуальной машины с именем VM04 и сохраняет объект в переменной $VM.
Вторая команда получает все объекты виртуального сетевого адаптера на VM04 и сохраняет объекты в массиве объектов $Adapters.
Последняя команда передает каждый объект, хранящийся в $Adapters, в Remove-SCVirtualNetworkAdapter, который удаляет все объекты виртуального сетевого адаптера из VM04.
Пример 5: Удаление второго виртуального сетевого адаптера с виртуальной машины с тремя виртуальными сетевыми адаптерами
PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters[1] | Remove-SCVirtualNetworkAdapter
Первая команда получает объект виртуальной машины с именем VM05 и сохраняет объект в переменной $VM.
Вторая команда получает все объекты виртуального сетевого адаптера на VM05 и сохраняет объекты в массиве объектов $Adapters. В этом примере предполагается, что VM05 имеет три виртуальных сетевых адаптера.
Последняя команда передает второй объект виртуального сетевого адаптера ($Adapters [1]) командлету Remove-SCVirtualNetworkAdapter , который удаляет этот объект виртуального сетевого адаптера из VM05.
Параметры
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-JobGroup
Указывает идентификатор для ряда команд, которые будут выполняться как набор непосредственно перед окончательной командой, которая включает тот же идентификатор группы заданий.
Свойства параметра
| Тип: | Guid |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
VirtualNicSpecified
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-JobVariable
Указывает, что ход выполнения задания отслеживается и хранится в переменной с именем этого параметра.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OnBehalfOfUser
Указывает имя пользователя. Этот командлет работает от имени пользователя, указанного в этом параметре.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OnBehalfOfUserRole
Указывает роль пользователя. Чтобы получить роль пользователя, используйте командлет Get-SCUserRole . Этот командлет работает от имени роли пользователя, указанной в этом параметре.
Свойства параметра
| Тип: | UserRole |
| 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 |
-SlotID
Указывает числовой идентификатор, используемый для идентификации устройства.
Свойства параметра
| Тип: | Int32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
SlotIdSpecified
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-VirtualNetworkAdapter
Указывает объект виртуального сетевого адаптера для виртуальной машины.
Типы узлов поддерживают следующее количество виртуальных сетевых адаптеров:
- Гипер-V. До четырех эмулируемых адаптеров на одну виртуальную машину. Драйвер для эмулированного сетевого адаптера в гостевой операционной системе Windows Server 2003 x64 отсутствует.
- Гипер-V. До восьми синтетических адаптеров на виртуальную машину.
- VMware ESX. До четырех эмулируемых адаптеров на одну виртуальную машину.
- Citrix XenServer. До семи эмулируемых адаптеров на одну виртуальную машину.
Свойства параметра
| Тип: | VirtualNetworkAdapter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
VirtualNicSpecified
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Примечания
- Требуется объект виртуального сетевого адаптера VMM, который можно получить с помощью командлета Get-SCVirtualNetworkAdapter .