Remove-SCVirtualDVDDrive
从 VMM 中删除虚拟 DVD 驱动器对象。
语法
Remove-SCVirtualDVDDrive
[-VirtualDVDDrive] <VirtualDVDDrive>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Remove-SCVirtualDVDDrive
-SourceBus <Byte>
-SourceLUN <Byte>
-JobGroup <Guid>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
说明
Remove-SCVirtual DVDDrive cmdlet 从硬件配置文件、虚拟机或虚拟机模板(VMM)环境中删除一个或多个虚拟 DVD 驱动器对象。 该 cmdlet 还会从库服务器上的文件系统中删除虚拟 DVD 驱动器使用的任何.iso文件。
此 cmdlet 在成功时返回对象(属性 MarkedForDeletion 设置为 True),或在失败时返回错误消息。
示例
示例 1:从虚拟机中删除特定虚拟 DVD 驱动器
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM | where { $_.Bus -eq 1 -and $_.LUN -eq 0 }
PS C:\> Remove-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive
第一个命令获取名为 VM01 的虚拟机对象,并将该对象存储在$VM变量中。
第二个命令获取位于 VM01 上的 IDE 总线上的辅助通道的第一个槽(由 -Bus 1 和 -LUN 0 指定)上的虚拟 DVD 驱动器对象,然后将虚拟 DVD 驱动器对象存储在$DVDDrive变量中。
最后一个命令从 VM01 中删除存储在$DVDDrive中的虚拟 DVD 驱动器对象,并从库服务器上的文件系统中删除此虚拟 DVD 驱动器使用的任何.iso文件。
示例 2:从虚拟机中删除第三个虚拟 DVD 驱动器
PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM
PS C:\> $DVDDrive[2] | Remove-SCVirtualDVDDrive
第一个命令获取名为 VM02 的虚拟机对象,并将该对象存储在$VM变量中。
第二个命令获取连接到 VM02 的所有虚拟 DVD 驱动器对象,并将每个虚拟 DVD 驱动器对象存储在$DVDDrive对象数组中。 此示例假定 VM02 有三个虚拟 DVD 驱动器,因此该数组包含三个元素(计数为 0 到 2)。
最后一个命令将存储在$DVDDrive中的第三个虚拟 DVD 驱动器(对象 [2])传递给 Remove-SCVirtual DVDDrive cmdlet,该 cmdlet 从 VM02 中删除此虚拟 DVD 驱动器对象,并从库服务器上的文件系统中删除此虚拟 DVD 驱动器使用的任何.iso文件。
参数
-Confirm
在运行 cmdlet 之前,提示你进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-JobGroup
指定一系列命令的标识符,该命令将在包含相同作业组标识符的最终命令运行之前作为集运行。
类型: | Guid |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-JobVariable
指定在此参数命名的变量中跟踪和存储作业进度。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | 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 |
-SourceBus
指定驱动器的源 IDE 总线。
类型: | Byte |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-SourceLUN
指定 IDE 总线上虚拟 DVD 驱动器对象的源逻辑单元号(LUN)。
类型: | Byte |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-VirtualDVDDrive
指定虚拟 DVD 驱动器对象。
类型: | VirtualDVDDrive |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
备注
- 需要 VMM 虚拟 DVD 驱动器对象,可以使用 Get-SCVirtual DVDDrive cmdlet 来检索该对象。