Remove-SCVirtualDVDDrive

Модуль:
VirtualMachineManager Module

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

Синтаксис

VirtualDVDDriveSpecified 

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

SourceBusAndLunSpecified 

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

Описание

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

Запрашивает подтверждение перед запуском 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

Наборы параметров

VirtualDVDDriveSpecified
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

-SourceBus

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

Свойства параметра

Тип:Byte
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SourceBusAndLunSpecified
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SourceLUN

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

Свойства параметра

Тип:Byte
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SourceBusAndLunSpecified
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VirtualDVDDrive

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

Свойства параметра

Тип:VirtualDVDDrive
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

VirtualDVDDriveSpecified
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.

Примечания

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