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

Set-SCVirtualDVDDrive

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

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

Синтаксис

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

Описание

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

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

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

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

  • Запись сведений с физического компакт-диска или DVD-диска на узле без указания буквы диска.

  • Запись сведений из ISO-файла образа, хранящегося в библиотеке VMM.

  • Запись "без носителя" (используется для отключения виртуального 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, а не в консоли 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, к другой позиции в шине интегрированной среды разработки, задав для логического номера единицы (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-диск или гибкий диск на виртуальной машине будет подключен к любому соответствующему физическому диску на узле. Это сопоставление возникает при развертывании сохраненной виртуальной машины на узле или при использовании шаблона или профиля оборудования для создания и развертывания виртуальной машины на узле.

Type:SwitchParameter
Aliases:AnyHostDrive
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Bus

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

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

-ISO

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

Type:ISO
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-Link

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

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

-LUN

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

  • Пример формата: -IDE -Bus 1 -LUN 0
  • Пример формата: -SCSI -Bus 0 -LUN 1
Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoMedia

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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

-VMHostDrive

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

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

  • Жесткий диск узла Hyper-V: "C:"
  • Floppy-диск узла Hyper-V: "A:"
  • Жесткий диск узла VMware ESX: "/dev/tools"
  • Floppy-диск узла VMware ESX: "/dev/sda"
  • Жесткий диск узла Citrix XenServer: "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
  • Диск floppy узла Citrix XenServer: не поддерживается
Type:String
Aliases:HostDrive
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

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

VirtualDVDDrive

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

Примечания

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