New-SCVirtualDVDDrive
在虛擬機器、虛擬機器範本或 VMM 中使用的硬體設定檔上建立虛擬 DVD 磁片磁碟機。
Syntax
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>]
Description
New-SCVirtual DVDDrive Cmdlet 會在虛擬機器、虛擬機器範本或 Virtual Machine Manager (VMM) 環境中使用的硬體設定檔上建立虛擬 DVD 磁片磁碟機物件。 根據預設,New-SCVirtualDVDDrive所建立的虛擬 DVD 磁片磁碟機不會連線到任何媒體。 您可以使用 Set-SCVirtualISODrive 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 磁片磁碟機連結至次要通道 (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 磁片磁碟機連結至次要通道 (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 是工作群組識別碼 (功能為識別元),可將包含此識別元的後續命令群組至單一工作群組。
第二個命令會建立新的虛擬 DVD 光碟機物件,並指定這個新的虛擬 DVD 光碟機可以使用任何可用的實體 DVD 光碟機。 此命令會將新的虛擬 DVD 光碟機連接至第二個 IDE 通道的第一個插槽 (IDE 是虛擬 DVD 光碟機唯一可以連接的匯流排類型)。 使用作業群組識別碼會指定此命令在包含 JobGroup 參數的最後一個命令執行之前,不會執行此命令。
第三個命令會取得名為 VMHost04 的主機物件,並將物件儲存在$VMHost變數中。
最後一個命令會建立虛擬機器、將它命名為 VM04、提供描述、指派擁有者,以及指定主機上用來儲存虛擬機器的位置。 此命令會使用作業群組識別碼,在New-SCVirtualMachine命令執行之前執行 New-SCVirtual 命令;產生的虛擬 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
指定 IDE 匯流排以連接虛擬磁碟機或虛擬 DVD 光碟機,或者是指定 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 磁片磁碟機物件的邏輯單元編號 (LUN) ,或指定 SCSI 匯流排上的虛擬磁片磁碟機物件。
- 範例格式:
-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 提示) 效能和資源優化提示的識別碼。 此參數可讓您稽核 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 |
-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 會傳回 VirtualMYDrive 物件。
備註
- 需要 VMM 虛擬機器物件、虛擬機器範本物件或硬體設定檔物件。 您可以分別使用 Get-SCVirtualMachine、 Get-SCVMTemplate或 Get-SCHardwareProfile Cmdlet 來擷取這些物件。