New-SCVirtualDVDDrive

模块:

VirtualMachineManager

在虚拟机、虚拟机模板或 VMM 中使用的硬件配置文件上创建虚拟 DVD 驱动器。

语法

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-SCVirtual DVDDrive cmdlet 在虚拟机、虚拟机模板或虚拟机管理器（VMM）环境中使用的硬件配置文件上创建虚拟 DVD 驱动器对象。 默认情况下，New-SCVirtualDVDDrive 创建的虚拟 DVD 驱动器未连接到任何媒体。 可以使用 Set-SCVirtual DVDDrive cmdlet 将虚拟 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变量中。

第二个命令在 VM01 上创建虚拟 DVD 驱动器，并通过指定 IDE 总线 1 和 LUN 1 将虚拟 DVD 驱动器附加到辅助通道（1）。

示例 2：在虚拟机模板上创建虚拟 DVD 驱动器

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualDVDDrive -VMTemplate $VMTemplate -Bus 1 -LUN 1

第一个命令获取名为 VMTemplate01 的虚拟机模板对象，并将对象存储在$Template变量中。

第二个命令在 VMTemplate01 上创建虚拟 DVD 驱动器，当模板用于创建虚拟机时，该驱动器将虚拟 DVD 驱动器附加到 IDE 总线上的辅助通道（1）。

示例 3：在硬件配置文件上创建虚拟 DVD 驱动器

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualDVDDrive -HardwareProfile $HWProfile -Bus 1 -LUN 1

第一个命令获取名为 NewHardwareProfile01 的硬件配置文件对象，并将对象存储在$HWProfile变量中。

第二个命令在 HardwareProfile1 上创建虚拟 DVD 驱动器，当使用硬件配置文件创建虚拟机时，该驱动器将虚拟 DVD 驱动器附加到 IDE 总线上的辅助通道（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 是一个作业组 ID，充当将后续命令分组到单个作业组中的标识符。

第二个命令创建新的虚拟 DVD 驱动器对象，并指定此新的虚拟 DVD 驱动器可以使用任何可用的物理 DVD 驱动器。 此命令会将新的虚拟 DVD 驱动器附加到第二个 IDE 通道的第一个槽（IDE 是唯一可以附加到虚拟 DVD 驱动器的总线类型）。 使用作业组 ID 指定在包含 jobGroup 参数运行的最后一个命令之前，此命令不会运行。

第三个命令获取名为 VMHost04 的主机对象，并将该对象存储在$VMHost变量中。

最后一个命令创建虚拟机，将其命名为 VM04，提供说明，分配所有者，并指定主机上用于存储虚拟机的位置。 该命令使用作业组 ID 在运行 New-SCVirtualMachine 命令之前运行 New-SCVirtualDVDDrive 命令;生成的虚拟 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变量中。

第二个命令获取名为WindowsServer2008R2.iso的 ISO 对象，并将对象存储在$ISO变量中。

最后一个命令在 VM05 上创建新的虚拟 DVD 驱动器，将其附加到 IDE 总线上的指定位置，并将其与存储在$ISO中的 ISO 映像链接。

参数

-AnyVMHostDrive

指示虚拟机上的虚拟 DVD 或软盘驱动器将连接到主机上的任何相应物理驱动器。 在主机上部署存储的虚拟机，或使用模板或硬件配置文件在主机上创建和部署虚拟机时，会发生此映射。

类型:	SwitchParameter
别名:	AnyHostDrive
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Bus

指定要将虚拟磁盘驱动器或虚拟 DVD 驱动器附加到的 IDE 总线，或附加到虚拟磁盘驱动器的 SCSI 总线。

类型:	Byte
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-HardwareProfile

指定硬件配置文件对象。

类型:	HardwareProfile
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ISO

指定 ISO 对象。

类型:	ISO
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-JobGroup

指定一系列命令的标识符，该命令将在包含相同作业组标识符的最终命令运行之前作为集运行。

类型:	Guid
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-JobVariable

指定在此参数命名的变量中跟踪和存储作业进度。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Link

指示资源应链接到而不是复制。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LUN

为虚拟磁盘驱动器对象或 IDE 总线上的虚拟 DVD 驱动器对象或 SCSI 总线上的虚拟磁盘驱动器对象指定逻辑单元号（LUN）。

• 示例格式：-IDE -Bus 1 -LUN 0
• 示例格式：-SCSI -Bus 0 -LUN 1

类型:	Byte
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-OnBehalfOfUser

指定用户名。 此 cmdlet 代表此参数指定的用户运行。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OnBehalfOfUserRole

指定用户角色。 若要获取用户角色，请使用 Get-SCUserRole cmdlet。 此 cmdlet 代表此参数指定的用户角色运行。

类型:	UserRole
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PROTipID

指定触发此操作的性能和资源优化提示（PRO 提示）的 ID。 此参数允许你审核 PRO 提示。

类型:	Guid
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RunAsynchronously

指示作业以异步方式运行，以便控件立即返回到命令行界面。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VM

指定虚拟机对象。

类型:	VM
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	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
别名:	HostDrive
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VMMServer

指定 VMM 服务器对象。

类型:	ServerConnection
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-VMTemplate

指定用于创建虚拟机的 VMM 模板对象。

类型:	Template
别名:	Template
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

输出

VirtualDVDDrive

此 cmdlet 返回 VirtualDVDDrive 对象。

备注

• 需要 VMM 虚拟机对象、虚拟机模板对象或硬件配置文件对象。 可以使用 Get-SCVirtualMachine、Get-SCVMTemplate或分别 Get-SCHardwareProfile cmdlet 来检索这些对象。

相关链接

• Get-SCHardwareProfile
• Get-SCISO
• Get-SCVirtualMachine
• Get-SCVirtualDVDDrive
• Get-SCVMHost
• Get-SCVMMServer
• Get-SCVMTemplate
• Remove-SCVirtualDVDDrive
• Set-SCVirtualDVDDrive