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

Remove-SCVirtualDVDDrive

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

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

Синтаксис

Remove-SCVirtualDVDDrive
      [-VirtualDVDDrive] <VirtualDVDDrive>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCVirtualDVDDrive
      -SourceBus <Byte>
      -SourceLUN <Byte>
      -JobGroup <Guid>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Описание

Командлет Remove-SCVirtualDVDDrive удаляет один или несколько объектов виртуального DVD-диска из профиля оборудования, виртуальной машины или шаблона виртуальной машины, используемого в среде Virtual Machine Manager (VMM). Командлет также удаляет ISO-файл, используемый виртуальным DVD-диском из файловой системы на сервере библиотеки.

Этот командлет возвращает объект после успешного выполнения (со свойством MarkedForDeletion, установленным значение True) или возвращает сообщение об ошибке при сбое.

Примеры

Пример 1. Удаление определенного виртуального DVD-диска с виртуальной машины

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM | where { $_.Bus -eq 1 -and $_.LUN -eq 0 }
PS C:\> Remove-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive

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

Вторая команда получает объект виртуального DVD-диска, расположенный в первом слоте дополнительного канала (заданный параметром -Bus 1 и -LUN 0) в шине IDE на VM01, а затем сохраняет объект виртуального DVD-диска в переменной $DVDDrive.

Последняя команда удаляет объект виртуального DVD-диска, хранящийся в $DVDDrive из VM01, и удаляет iso-файл, который этот виртуальный DVD-диск использует из файловой системы на сервере библиотеки.

Пример 2. Удаление третьего виртуального DVD-диска с виртуальной машины

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM
PS C:\> $DVDDrive[2] | Remove-SCVirtualDVDDrive

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

Вторая команда получает все объекты виртуального DVD-диска, подключенные к VM02, и сохраняет каждый объект виртуального DVD-диска в массиве объектов $DVDDrive. В этом примере предполагается, что vm02 имеет три виртуальных DVD-диска, поэтому массив содержит три элемента (от 0 до 2).

Последняя команда передает третий виртуальный DVD-диск (объект [2]), хранящийся в $DVDDrive командлету Remove-SCVirtualDVDDrive , который удаляет этот объект виртуального DVD-диска из VM02 и удаляет любой ISO-файл, используемый этим виртуальным DVD-диском из файловой системы на сервере библиотеки.

Параметры

-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

-SourceBus

Указывает исходную шину интегрированной среды разработки для диска.

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

-SourceLUN

Указывает исходный логический номер единицы (LUN) для объекта виртуального DVD-диска на шине интегрированной среды разработки.

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

-VirtualDVDDrive

Указывает объект виртуального DVD-диска.

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

Примечания

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