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

Remove-SCVirtualNetworkAdapter

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

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

Синтаксис

Remove-SCVirtualNetworkAdapter
      [-VirtualNetworkAdapter] <VirtualNetworkAdapter>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCVirtualNetworkAdapter
      -SlotID <Int32>
      -JobGroup <Guid>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Описание

Командлет Remove-SCVirtualNetworkAdapter удаляет один или несколько объектов виртуального сетевого адаптера из виртуальной машины, шаблона виртуальной машины или профиля оборудования, используемого в среде Virtual Machine Manager (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

Запрос подтверждения перед выполнением командлета.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

-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

-PROTipID

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

Type:Guid
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

-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

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

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

Примечания

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