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 驱动器，该驱动器在 IDE 总线上使用硬件配置文件创建虚拟机时，将虚拟 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 是一个用作标识符的作业组 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 或软盘驱动器将连接到主机上的任何相应物理驱动器。 在主机上部署存储的虚拟机，或使用模板或硬件配置文件在主机上创建和部署虚拟机时，会发生此映射。

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

-Bus

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

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

-HardwareProfile

指定硬件配置文件对象。

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

-ISO

指定 ISO 对象。

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

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

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

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

-OnBehalfOfUser

指定用户名。 此 cmdlet 代表此参数指定的用户操作。

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

-OnBehalfOfUserRole

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

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

-PROTipID

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

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

-RunAsynchronously

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

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

-VM

指定一个虚拟机对象。

Type:	VM
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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 主机软盘：不支持

Type:	String
Aliases:	HostDrive
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMMServer

指定VMM 服务器对象。

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

-VMTemplate

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

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