Remove-SCVirtualDVDDrive
從 VMM 移除虛擬 DVD 磁片磁碟機物件。
Syntax
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-SCVirtual DVDDrive Cmdlet 會從硬體設定檔、虛擬機器或 Virtual Machine Manager 中使用的虛擬機器範本中移除一或多個虛擬 DVD 磁片磁碟機物件, (VMM) 環境。 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 變數中。
第二個命令會取得虛擬 DVD 磁片磁碟機物件,該物件位於 VM01 上 IDE 匯流排上由 -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 前提示您確認。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
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 |
-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 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 PRO 秘訣。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
表示作業會以非同步方式執行,讓控制項立即返回命令殼層。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceBus
指定磁片磁碟機的來源 IDE 匯流排。
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceLUN
指定 IDE 匯流排上虛擬 DVD 磁片磁碟機物件的來源邏輯單元編號 (LUN) 。
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VirtualDVDDrive
指定虛擬 DVD 光碟機物件。
Type: | VirtualDVDDrive |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
備註
- 需要 VMM 虛擬 DVD 磁片磁碟機物件,可以使用 Get-SCVirtual DVDDrive Cmdlet 來擷取。