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

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

Тип: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 соответственно.