Set-SCVirtualDVDDrive

Изменяет свойства виртуального DVD-дисковода, связанного с виртуальной машиной, шаблоном виртуальной машины или профилем оборудования, используемым в VMM.

Синтаксис

BusChangesWithVirtualDVDDriveSpecified (по умолчанию)

Set-SCVirtualDVDDrive
    [-VirtualDVDDrive] <VirtualDVDDrive>
    [-Bus <Byte>]
    [-LUN <Byte>]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

NoMediaWithSourceBusAndLunSpecified

Set-SCVirtualDVDDrive
    -JobGroup <Guid>
    -SourceBus <Byte>
    -SourceLUN <Byte>
    [-Bus <Byte>]
    [-LUN <Byte>]
    [-NoMedia]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

HostDriveWithVirtualDVDDriveSpecified

Set-SCVirtualDVDDrive
    [-VirtualDVDDrive] <VirtualDVDDrive>
    -VMHostDrive <String>
    [-Bus <Byte>]
    [-LUN <Byte>]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

NoMediaWithVirtualDVDDriveSpecified

Set-SCVirtualDVDDrive
    [-VirtualDVDDrive] <VirtualDVDDrive>
    [-Bus <Byte>]
    [-LUN <Byte>]
    [-NoMedia]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

AnyHostDriveWithVirtualDVDDriveSpecified

Set-SCVirtualDVDDrive
    [-VirtualDVDDrive] <VirtualDVDDrive>
    [-Bus <Byte>]
    [-LUN <Byte>]
    [-JobGroup <Guid>]
    [-AnyVMHostDrive]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

ISOWithSourceBusAndLunSpecified

Set-SCVirtualDVDDrive
    -ISO <ISO>
    -JobGroup <Guid>
    -SourceBus <Byte>
    -SourceLUN <Byte>
    [-Bus <Byte>]
    [-LUN <Byte>]
    [-Link]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

HostDriveWithSourceBusAndLunSpecified

Set-SCVirtualDVDDrive
    -VMHostDrive <String>
    -JobGroup <Guid>
    -SourceBus <Byte>
    -SourceLUN <Byte>
    [-Bus <Byte>]
    [-LUN <Byte>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

ISOWithVirtualDVDDriveSpecified

Set-SCVirtualDVDDrive
    [-VirtualDVDDrive] <VirtualDVDDrive>
    -ISO <ISO>
    [-Bus <Byte>]
    [-LUN <Byte>]
    [-Link]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

AnyHostDriveWithSourceBusAndLunSpecified

Set-SCVirtualDVDDrive
    -JobGroup <Guid>
    -SourceBus <Byte>
    -SourceLUN <Byte>
    [-Bus <Byte>]
    [-LUN <Byte>]
    [-AnyVMHostDrive]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

BusChangesWithSourceBusAndLunSpecified

Set-SCVirtualDVDDrive
    -JobGroup <Guid>
    -SourceBus <Byte>
    -SourceLUN <Byte>
    [-Bus <Byte>]
    [-LUN <Byte>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Описание

Командлет Set-SCVirtualDVDDrive изменяет одно или несколько свойств объекта виртуального DVD-дисковода, связанного с виртуальной машиной, шаблоном виртуальной машины или профилем оборудования, используемым в среде диспетчера виртуальных машин (VMM).

С помощью этого командлета можно подключить виртуальный DVD-дисковод к физическому DVD-дисководу на сервере виртуальной машины, в другом расположении на шине IDE или к ISO-образу, а также для отключения виртуального DVD-дисковода.

Большинство параметров, которые можно настроить для виртуального DVD-привода на виртуальной машине, одинаковы независимо от того, является ли платформой виртуализации узла Hyper-V, VMware или Citrix XenServer. Все эти платформы виртуализации поддерживают следующее:

  • Подключение виртуального DVD-привода к основному или вторичному каналу на хосте.

  • Захват информации с физического CD или DVD привода на хосте без указания буквы дисковода.

  • Захват информации из файла изображения (ISO), хранящегося в библиотеке VMM.

  • Захват "no media" (используется для отключения виртуального DVD-привода от хост-диска или от ISO-файла).

Единственный параметр, который зависит от платформы виртуализации для этого командлета, заключается в том, можно ли использовать ISO-файл непосредственно из библиотеки VMM:

  • Hyper-V ведущий. Если вы настроили подключение к ISO-файлу в библиотеке VMM, вы можете использовать ISO-образ непосредственно из библиотеки, а не копировать его на хост.

  • Хост VMware ESX. Если вы настраиваете подключение к ISO-файлу в библиотеке VMM, вы не можете использовать ISO-образ непосредственно из библиотеки, а вместо этого должны принять значение по умолчанию, которое копирует ISO-файл на хост.

  • Хост Citrix XenServer. Если вы настраиваете подключение к ISO-файлу в библиотеке VMM, вы не можете использовать ISO-образ непосредственно из библиотеки, а вместо этого должны принять значение по умолчанию, которое копирует ISO-файл на хост. Хост должен иметь по крайней мере один ISO-репозиторий с доступом на запись и достаточно места для хранения ISO-файла.

Примечание: Если виртуальный DVD-привод настроен на виртуальной машине, созданной с помощью мастера виртуальных машин в консоли Hyper-V Manager, а не в консоли VMM, необходимо указать букву дисковода. Эта буква диска будет отображаться в свойствах этой виртуальной машины в консоли VMM.

Примеры

Пример 1: Подключение виртуального DVD-привода к физическому 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:\> Set-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive -VMHostDrive "E:"

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

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

Последняя команда соединяет объект виртуального DVD-привода, хранящийся в $DVDDrive, с физическим приводом на хосте (дисководом D:). Он также удаляет все ISO-файлы, которые ранее использовался виртуальным DVD-приводом, если ни одна другая виртуальная машина в настоящее время не использует этот ISO-файл.

Пример 2: Подключение виртуального DVD-привода к другому месту на шине IDE

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

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

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

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

Пример 3: Отключите виртуальный DVD-привод

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

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

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

Последняя команда использует параметр NoMedia для отключения объекта виртуального DVD-привода, хранящегося в $DVDDrive, от любого хост-диска или ISO-образа, к которому он подключен. Он также удаляет все ISO-файлы, которые ранее использовался виртуальным DVD-приводом, если ни одна другая виртуальная машина в настоящее время не использует этот ISO-файл.

Пример 4: Подключите виртуальный DVD-привод на существующей виртуальной машине к любому доступному физическому DVD-приводу

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> Set-SCVirtualDVDDrive -AnyVMHostDrive -VirtualDVDDrive (Get-VirtualDVDDrive -VM $VM | where {$_.Bus -eq 1 -and $_.Lun -eq 0})

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

Последняя команда получает объект виртуального DVD-привода, который находится на первом слоте вторичного канала (указанного в -Bus 1 и -LUN 0) на шине IDE на VM04. Команда использует командлет Set-SCVirtualDVDDrive с параметром AnyVMHostDrive для подключения виртуального DVD-привода к любому доступному физическому DVD-приводу на хосте.

Параметры

-AnyVMHostDrive

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

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

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

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

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

-Bus

Указывает шину IDE, к которой следует подключить виртуальный дисковод или виртуальный DVD-привод, или шину SCSI, к которой следует подключить виртуальный дисковод.

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

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

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

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

-ISO

Указывает объект ISO.

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

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

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

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

-JobGroup

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

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

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

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

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

-JobVariable

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

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

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

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

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

Указывает, что на ресурс следует ссылаться, а не копировать.

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
ISOWithSourceBusAndLunSpecified
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ISOWithVirtualDVDDriveSpecified
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-LUN

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

  • Пример формата: -IDE -Bus 1 -LUN 0
  • Пример формата: -SCSI -Bus 0 -LUN 1

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

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

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

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

-NoMedia

Отключает виртуальный DVD-дисковод от главного дисковода или ISO-образа, к которому он был подключен, или отключает виртуальный дисковод гибких дисков от главного дисковода или виртуальной дискеты, к которым он был подключен.

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

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

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

NoMediaWithSourceBusAndLunSpecified
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
NoMediaWithVirtualDVDDriveSpecified
Position:Named
Обязательно:True
Значение из конвейера: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

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

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

-SourceLUN

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

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

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

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

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

-VirtualDVDDrive

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

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

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

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

BusChangesWithVirtualDVDDriveSpecified
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
HostDriveWithVirtualDVDDriveSpecified
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
NoMediaWithVirtualDVDDriveSpecified
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
AnyHostDriveWithVirtualDVDDriveSpecified
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ISOWithVirtualDVDDriveSpecified
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMHostDrive

Указывает диск на узле виртуальной машины.

Примеры форматов:

  • Hyper-V жесткий диск хоста: "C:"
  • Hyper-V хостовый дисковод гибких дисков: "A:"
  • Жесткий диск узла VMware ESX: "/dev/tools"
  • Хост-дисковод гибких дисков VMware ESX: "/dev/sda"
  • Жесткий диск хоста Citrix XenServer: "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
  • Хостовый дисковод гибких дисков Citrix XenServer: не поддерживается

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

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

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

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

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Выходные данные

VirtualDVDDrive

Этот командлет возвращает объект VirtualDVDDrive .

Примечания

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