New-SCVirtualDVDDrive
仮想マシン、仮想マシン テンプレート、または 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-SCVirtualDVDDrive コマンドレットは、仮想マシン、仮想マシン テンプレート、または仮想マシン マネージャー (VMM) 環境で使用されるハードウェア プロファイルに仮想 DVD ドライブ オブジェクトを作成します。 既定では、New-SCVirtualDVDDrive によって作成された仮想 DVD ドライブはどのメディアにも接続されません。 Set-SCVirtualDVDDrive コマンドレットを使用して、仮想 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 変数に格納します。
2 番目のコマンドは、VM01 に仮想 DVD ドライブを作成し、IDE Bus 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変数にオブジェクトを格納します。
2 番目のコマンドは、仮想マシンの作成にテンプレートを使用するときに、仮想 DVD ドライブを IDE バスのセカンダリ チャネル (1) に接続する仮想 DVD ドライブを VMTemplate01 に作成します。
例 3: ハードウェア プロファイルに仮想 DVD ドライブを作成する
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualDVDDrive -HardwareProfile $HWProfile -Bus 1 -LUN 1最初のコマンドは、NewHardwareProfile01 という名前のハードウェア プロファイル オブジェクトを取得し、$HWProfile変数にオブジェクトを格納します。
2 番目のコマンドは、ハードウェア プロファイルを使用して仮想マシンを作成するときに、仮想 DVD ドライブを IDE バスのセカンダリ チャネル (1) に接続する仮想 DVD ドライブを HardwareProfile1 に作成します。
例 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 は、この識別子を含む後続のコマンドを 1 つのジョブ グループにグループ化する識別子として機能するジョブ グループ ID です。
2 番目のコマンドは、新しい仮想 DVD ドライブ オブジェクトを作成し、この新しい仮想 DVD ドライブで使用可能な物理 DVD ドライブを使用できることを指定します。 このコマンドは、新しい仮想 DVD ドライブを 2 番目の IDE チャネルの最初のスロットにアタッチします (IDE は、仮想 DVD ドライブを接続できる唯一のバスの種類です)。 ジョブ グループ ID を使用すると、JobGroup パラメーターを含む最後のコマンドが実行される直前まで、このコマンドが実行されないことが指定されます。
3 番目のコマンドは、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 変数に格納します。
2 番目のコマンドは、WindowsServer2008R2.isoという名前の ISO オブジェクトを取得し、$ISO変数にオブジェクトを格納します。
最後のコマンドは、VM05 に新しい仮想 DVD ドライブを作成し、IDE バス上の指定された場所に接続し、$ISOに格納されている ISO イメージとリンクします。
パラメーター
-AnyVMHostDrive
仮想マシン上の仮想 DVD またはフロッピー ドライブが、ホスト上の対応する物理ドライブに接続されることを示します。 このマッピングは、格納されている仮想マシンをホストにデプロイするとき、またはテンプレートまたはハードウェア プロファイルを使用してホスト上に仮想マシンを作成してデプロイする場合に発生します。
| 型: | SwitchParameter |
| Aliases: | AnyHostDrive |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Bus
仮想ディスク ドライブまたは仮想 DVD ドライブを接続する IDE バス、または仮想ディスク ドライブを接続する SCSI バスを指定します。
| 型: | Byte |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-HardwareProfile
ハードウェア プロファイル オブジェクトを指定します。
| 型: | HardwareProfile |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ISO
ISO オブジェクトを指定します。
| 型: | ISO |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobGroup
同じジョブ グループ識別子を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの識別子を指定します。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Link
コピーするのではなく、リソースをリンクする必要があることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-LUN
仮想ディスク ドライブ オブジェクト、IDE バス上の仮想 DVD ドライブ オブジェクト、または SCSI バス上の仮想ディスク ドライブ オブジェクトの論理ユニット番号 (LUN) を指定します。
- 形式の例:
-IDE -Bus 1 -LUN 0 - 形式の例:
-SCSI -Bus 0 -LUN 1
| 型: | Byte |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
| 型: | UserRole |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VM
仮想マシン オブジェクトを指定します。
| 型: | VM |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | 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 ホスト フロッピー ドライブ: サポートされていません
| 型: | String |
| Aliases: | HostDrive |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VMTemplate
仮想マシンの作成に使用する VMM テンプレート オブジェクトを指定します。
| 型: | Template |
| Aliases: | Template |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
VirtualDVDDrive
このコマンドレットは、VirtualDVDDrive オブジェクト
メモ
- VMM 仮想マシン オブジェクト、仮想マシン テンプレート オブジェクト、またはハードウェア プロファイル オブジェクトが必要です。 これらのオブジェクトは、Get-SCVirtualMachine
、 Get-SCVMTemplate 、または Get-SCHardwareProfile コマンドレットをそれぞれして取得できます。