New-SCVirtualDVDDrive
Создает виртуальный DVD-привод на виртуальной машине, шаблон виртуальной машины или профиль оборудования, используемый в VMM.
Синтаксис
JobGroup
New-SCVirtualDVDDrive
-Bus <Byte>
-LUN <Byte>
-JobGroup <Guid>
[-VMMServer <ServerConnection>]
[-Link]
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
HardwareProfile
New-SCVirtualDVDDrive
-Bus <Byte>
-LUN <Byte>
-HardwareProfile <HardwareProfile>
[-Link]
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
VM
New-SCVirtualDVDDrive
-Bus <Byte>
-LUN <Byte>
-VM <VM>
[-Link]
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Template
New-SCVirtualDVDDrive
-Bus <Byte>
-LUN <Byte>
-VMTemplate <Template>
[-Link]
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Описание
Командлет New-SCVirtualDVDDrive создает объект виртуального DVD-дисковода на виртуальной машине, шаблон виртуальной машины или профиль оборудования, используемый в среде диспетчера виртуальных машин (VMM). По умолчанию виртуальный DVD-привод, созданный New-SCVirtualDVDDrive, не подключен ни к какому носителю. С помощью командлета Set-SCVirtualDVDDrive можно подключить виртуальный DVD-дисковод к физическому DVD-дисководу на узле виртуальной машины или к ISO-образу.
Примечание: Вы можете подключить виртуальный DVD-привод к устройству IDE на виртуальной машине, но вы не можете подключить виртуальный 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 1 и LUN 1.
Пример 2: Создание виртуального DVD-привода на основе шаблона виртуальной машины
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualDVDDrive -VMTemplate $VMTemplate -Bus 1 -LUN 1
Первая команда получает объект шаблона виртуальной машины с именем VMTemplate01 и сохраняет объект в переменной $Template.
Вторая команда создает виртуальный DVD-привод на VMTemplate01, который подключает виртуальный DVD-привод к вторичному каналу (1) на шине IDE, когда шаблон используется для создания виртуальной машины.
Пример 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) на шине IDE, когда аппаратный профиль используется для создания виртуальной машины.
Пример 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-привод к первому слоту второго канала IDE (IDE — единственный тип шины, к которому можно подключить виртуальный DVD-привод). Использование идентификатора группы заданий указывает, что эта команда не будет выполняться до тех пор, пока не будет выполнена последняя команда, включающая параметр JobGroup .
Третья команда получает объект host с именем 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, подключает его к указанному месту на шине IDE и связывает с ISO-образом, хранящимся в $ISO.
Параметры
-AnyVMHostDrive
Указывает, что виртуальный DVD-диск или дисковод гибких дисков на виртуальной машине будет подключен к любому соответствующему физическому дисководу на узле. Это сопоставление происходит при развертывании хранимой виртуальной машины на узле или при использовании шаблона или профиля оборудования для создания и развертывания виртуальной машины на узле.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | AnyHostDrive |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Bus
Указывает шину IDE, к которой следует подключить виртуальный дисковод или виртуальный DVD-привод, или шину SCSI, к которой следует подключить виртуальный дисковод.
Свойства параметра
| Тип: | Byte |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-HardwareProfile
Указывает объект профиля оборудования.
Свойства параметра
| Тип: | HardwareProfile |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
HardwareProfile
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ISO
Указывает объект ISO.
Свойства параметра
| Тип: | ISO |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-JobGroup
Указывает идентификатор для ряда команд, которые будут выполняться как набор непосредственно перед окончательной командой, которая включает тот же идентификатор группы заданий.
Свойства параметра
| Тип: | Guid |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
JobGroup
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-JobVariable
Указывает, что ход выполнения задания отслеживается и хранится в переменной с именем этого параметра.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Link
Указывает, что на ресурс следует ссылаться, а не копировать.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| 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 |
| Обязательно: | 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 |
-VM
Указывает объект виртуальной машины.
Свойства параметра
| Тип: | VM |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
VM
| Position: | Named |
| Обязательно: | 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: | ХостДрайв |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-VMMServer
Указывает объект сервера VMM.
Свойства параметра
| Тип: | ServerConnection |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
JobGroup
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-VMTemplate
Указывает объект шаблона VMM, используемый для создания виртуальных машин.
Свойства параметра
| Тип: | Template |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Шаблон |
Наборы параметров
Template
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Выходные данные
VirtualDVDDrive
Этот командлет возвращает объект VirtualDVDDrive .
Примечания
- Требуется объект виртуальной машины VMM, объект шаблона виртуальной машины или объект профиля оборудования. Эти объекты можно получить с помощью командлетов Get-SCVirtualMachine, Get-SCVMTemplate или Get-SCHardwareProfile соответственно.