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>]
Description
Remove-SCVirtualDVDDrive Cmdlet 會從硬體設定檔、虛擬機或 Virtual Machine Manager (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 總線上取得位於次要通道第一個插槽上的虛擬 DVD 磁碟驅動器物件(由 -Bus 1 和 -LUN 0 指定),然後將虛擬 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,這會從 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 提示) 的識別碼。 此參數可讓您稽核 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-SCVirtualDVDDrive Cmdlet
來擷取。