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

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) на шине интегрированной среды разработки на 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

Запрашивает подтверждение перед запуском командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-JobGroup

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

Тип:Guid
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-JobVariable

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OnBehalfOfUser

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OnBehalfOfUserRole

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

Тип:UserRole
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PROTipID

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

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RunAsynchronously

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SourceBus

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

Тип:Byte
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SourceLUN

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

Тип:Byte
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VirtualDVDDrive

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

Тип:VirtualDVDDrive
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Примечания

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