New-SCVirtualDVDDrive
Создает виртуальный DVD-диск на виртуальной машине, шаблон виртуальной машины или профиль оборудования, используемый в VMM.
Синтаксис
New-SCVirtualDVDDrive
[-VMMServer <ServerConnection>]
-Bus <Byte>
-LUN <Byte>
[-Link]
-JobGroup <Guid>
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
New-SCVirtualDVDDrive
-Bus <Byte>
-LUN <Byte>
[-Link]
-HardwareProfile <HardwareProfile>
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
New-SCVirtualDVDDrive
-Bus <Byte>
-LUN <Byte>
[-Link]
-VM <VM>
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
New-SCVirtualDVDDrive
-Bus <Byte>
-LUN <Byte>
[-Link]
-VMTemplate <Template>
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Описание
Командлет New-SCVirtualDVDDrive создает объект виртуального DVD-диска на виртуальной машине, шаблон виртуальной машины или профиль оборудования, используемый в среде Virtual Machine Manager (VMM). По умолчанию виртуальный DVD-диск, созданный New-SCVirtualDVDDrive, не подключен к любому носителю. Вы можете использовать командлет Set-SCVirtualDVDDrive для подключения виртуального DVD-диска к физическому DVD-диску на узле виртуальной машины или с ISO-образом.
Примечание. Вы можете подключить виртуальный DVD-диск к устройству интегрированной среды разработки на виртуальной машине, но вы не можете подключить виртуальный DVD-диск к адаптеру SCSI на виртуальной машине.
Примеры
Пример 1. Создание виртуального DVD-диска на виртуальной машине
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualDVDDrive -VM $VM -Bus 1 -LUN 1
Первая команда получает объект виртуальной машины с именем VM01 и сохраняет объект в переменной $VM.
Вторая команда создает виртуальный DVD-диск на vm01 и подключает виртуальный DVD-диск к дополнительному каналу (1), указав IDE Bus 1 и LUN 1.
Пример 2. Создание виртуального DVD-диска на шаблоне виртуальной машины
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualDVDDrive -VMTemplate $VMTemplate -Bus 1 -LUN 1
Первая команда получает объект templat виртуальной машины с именем VMTemplate01 и сохраняет объект в переменной $Template.
Вторая команда создает виртуальный DVD-диск на vmTemplate01, который подключает виртуальный DVD-диск к дополнительному каналу (1) на шине интегрированной среды разработки при использовании шаблона для создания виртуальной машины.
Пример 3. Создание виртуального DVD-диска в профиле оборудования
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualDVDDrive -HardwareProfile $HWProfile -Bus 1 -LUN 1
Первая команда получает объект профиля оборудования с именем NewHardwareProfile01 и сохраняет объект в переменной $HWProfile.
Вторая команда создает виртуальный DVD-диск в HardwareProfile1, который подключает виртуальный DVD-диск к дополнительному каналу (1) на шине интегрированной среды разработки при использовании профиля оборудования для создания виртуальной машины.
Пример 4. Создание виртуальной машины с виртуальным DVD-диском, который подключается к любому доступному физическому DVD-диску на узле
PS C:\> $JobGroupId = [Guid]::NewGuid().ToString()
PS C:\> New-SCVirtualDVDDrive -VMMServer "VMMServer01.Contoso.com" -JobGroup $JobGroupId -Bus 1 -LUN 0 -AnyVMHostDrive
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost04"
PS C:\> New-SCVirtualMachine -Name "VM04" -Description "A new VM with a DVD drive" -VMMServer "VMMServer01.Contoso.com" -Owner "Contoso\Katarina" -VMHost $VMHost -Path "D:\VirtualMachinePath" -StartVM -JobGroup $JobGroupId
Первая команда создает новую строку GUID и сохраняет ее в переменных $JobGroupID. Этот GUID — это идентификатор группы заданий, который работает в качестве идентификатора, который группирует последующие команды, которые включают этот идентификатор в одну группу заданий.
Вторая команда создает новый объект виртуального DVD-диска и указывает, что этот новый виртуальный DVD-диск может использовать любой доступный физический DVD-диск. Команда прикрепит новый виртуальный DVD-диск к первому слоту второго канала интегрированной среды разработки (интегрированная среда разработки — единственный тип шины, к которому можно подключить виртуальный DVD-диск). При использовании идентификатора группы заданий указывается, что эта команда не выполняется до тех пор, пока не будет выполнена окончательная команда, которая включает параметр JobGroup.
Третья команда получает объект узла с именем VMHost04 и сохраняет объект в переменной $VMHost.
Последняя команда создает виртуальную машину, именует ее VM04, предоставляет описание, назначает владельца и указывает расположение на узле для хранения виртуальной машины. Команда использует идентификатор группы заданий для выполнения команды New-SCVirtualDVDDrive непосредственно перед выполнением команды New-SCVirtualMachine; Результирующий объект виртуального DVD-диска связан с новой виртуальной машиной.
Пример 5. Добавление нового виртуального DVD-диска на существующую виртуальную машину и подключение ISO-файла из библиотеки к диску
PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $ISO = Get-SCISO | where {$_.Name -eq "WindowsServer2008R2.iso"}
PS C:\> New-SCVirtualDVDDrive -VM $VM -ISO $ISO -Bus 1 -LUN 1
Первая команда получает объект виртуальной машины с именем VM05 и сохраняет объект в переменной $VM.
Вторая команда получает объект ISO с именем WindowsServer2008R2.iso и сохраняет объект в переменной $ISO.
Последняя команда создает новый виртуальный DVD-диск на vm05, присоединяет его к указанному расположению в шине интегрированной среды разработки и связывает его с образом ISO, хранящимся в $ISO.
Параметры
-AnyVMHostDrive
Указывает, что виртуальный DVD-диск или диск floppy на виртуальной машине будет подключен к любому физическому диску на узле. Это сопоставление возникает при развертывании хранимой виртуальной машины на узле или при использовании шаблона или профиля оборудования для создания и развертывания виртуальной машины на узле.
Тип: | SwitchParameter |
Aliases: | AnyHostDrive |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Bus
Указывает шину интегрированной среды разработки, к которой необходимо подключить виртуальный диск или виртуальный DVD-диск, или шину SCSI, к которой необходимо подключить виртуальный диск.
Тип: | Byte |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-HardwareProfile
Указывает объект профиля оборудования.
Тип: | HardwareProfile |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-ISO
Указывает объект ISO.
Тип: | ISO |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-JobGroup
Указывает идентификатор для ряда команд, которые будут выполняться как набор непосредственно перед окончательной командой, которая включает тот же идентификатор группы заданий.
Тип: | Guid |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-JobVariable
Указывает, что ход выполнения задания отслеживается и хранится в переменной с именем этого параметра.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Link
Указывает, что ресурс должен быть связан вместо копирования.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-LUN
Указывает логический номер единицы (LUN) для объекта виртуального диска или для объекта виртуального DVD-диска на шине интегрированной среды разработки или для объекта виртуального диска на шине SCSI.
- Пример формата:
-IDE -Bus 1 -LUN 0
- Пример формата:
-SCSI -Bus 0 -LUN 1
Тип: | Byte |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | 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 |
-VM
Указывает объект виртуальной машины.
Тип: | VM |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-VMHostDrive
Указывает диск на узле виртуальной машины.
Примеры форматов:
- жесткий диск Hyper-V узла:
"C:"
- диск Hyper-V узла:
"A:"
- Жесткий диск узла VMware ESX:
"/dev/tools"
- Диск floppy узла VMware ESX:
"/dev/sda"
- Жесткий диск Citrix XenServer:
"Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
- Диск floppy узла Citrix XenServer: не поддерживается
Тип: | String |
Aliases: | HostDrive |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-VMMServer
Указывает объект сервера VMM.
Тип: | ServerConnection |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-VMTemplate
Указывает объект шаблона VMM, используемый для создания виртуальных машин.
Тип: | Template |
Aliases: | Template |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Выходные данные
VirtualDVDDrive
Этот командлет возвращает объект VirtualDVDDrive.
Примечания
- Требуется объект виртуальной машины VMM, объект шаблона виртуальной машины или объект профиля оборудования. Эти объекты можно получить с помощью Get-SCVirtualMachine, Get-SCVMTemplateили командлетов Get-SCHardwareProfile соответственно.