Set-SCVirtualDVDDrive
VMM で使用される仮想マシン、仮想マシン テンプレート、またはハードウェア プロファイルに関連付けられている仮想 DVD ドライブのプロパティを変更します。
構文
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
[-VirtualDVDDrive] <VirtualDVDDrive>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
[-NoMedia]
-JobGroup <Guid>
-SourceBus <Byte>
-SourceLUN <Byte>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
[-VirtualDVDDrive] <VirtualDVDDrive>
-VMHostDrive <String>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
[-VirtualDVDDrive] <VirtualDVDDrive>
[-NoMedia]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
[-VirtualDVDDrive] <VirtualDVDDrive>
[-JobGroup <Guid>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
[-Link]
-ISO <ISO>
-JobGroup <Guid>
-SourceBus <Byte>
-SourceLUN <Byte>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
-VMHostDrive <String>
-JobGroup <Guid>
-SourceBus <Byte>
-SourceLUN <Byte>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
[-Link]
[-VirtualDVDDrive] <VirtualDVDDrive>
-ISO <ISO>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
-JobGroup <Guid>
[-AnyVMHostDrive]
-SourceBus <Byte>
-SourceLUN <Byte>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Set-SCVirtualDVDDrive
[-Bus <Byte>]
[-LUN <Byte>]
-JobGroup <Guid>
-SourceBus <Byte>
-SourceLUN <Byte>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
説明
Set-SCVirtualDVDDrive コマンドレットは、仮想マシン マネージャー (VMM) 環境で使用される仮想マシン、仮想マシン テンプレート、またはハードウェア プロファイルに関連付けられている仮想 DVD ドライブ オブジェクトの 1 つ以上のプロパティを変更します。
このコマンドレットを使用して、仮想 DVD ドライブを仮想マシン ホスト サーバー上の物理 DVD ドライブ、IDE バス上の別の場所、または ISO イメージに接続したり、それを使用して仮想 DVD ドライブを切断したりできます。
仮想マシン上の仮想 DVD ドライブに対して構成できるほとんどの設定は、ホストの仮想化プラットフォームが Hyper-V、VMware、Citrix XenServer のいずれであるかに関係なく同じです。 これらの仮想化プラットフォームはすべて、次の機能をサポートしています。
ホスト上のプライマリまたはセカンダリ チャネルに仮想 DVD ドライブを接続する。
ドライブ文字を指定せずに、ホスト上の物理 CD または DVD ドライブから情報をキャプチャする。
VMM ライブラリに格納されているイメージ (ISO) ファイルから情報をキャプチャする。
"メディアなし" をキャプチャします (ホスト ドライブまたは ISO ファイルから仮想 DVD ドライブを切断するために使用されます)。
仮想化プラットフォームによってこのコマンドレットによって異なる唯一の設定は、VMM ライブラリから直接 ISO ファイルを使用できるかどうかです。
ホスト Hyper-V。 VMM ライブラリで ISO ファイルへの接続を構成する場合は、ホストにコピーするのではなく、ライブラリから直接 ISO を使用するように選択できます。
VMware ESX ホスト。 VMM ライブラリで ISO ファイルへの接続を構成する場合、ライブラリから直接 ISO を使用することはできませんが、代わりに既定値をそのまま使用する必要があります。この場合、ISO ファイルがホストにコピーされます。
Citrix XenServer ホスト。 VMM ライブラリで ISO ファイルへの接続を構成する場合、ライブラリから直接 ISO を使用することはできませんが、代わりに既定値をそのまま使用する必要があります。この場合、ISO ファイルがホストにコピーされます。 ホストには、書き込みアクセス権と ISO ファイルを格納するための十分な記憶域を備えた少なくとも 1 つの ISO リポジトリが必要です。
注: 仮想 DVD ドライブが、VMM コンソールではなく、Hyper-V マネージャー コンソールの仮想マシン ウィザードを使用して作成された仮想マシンで構成されている場合は、ドライブ文字を指定する必要があります。 そのドライブ文字は、VMM コンソールのその仮想マシンのプロパティに表示されます。
例
例 1: 仮想 DVD ドライブを物理 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:\> Set-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive -VMHostDrive "E:"
最初のコマンドは、VM01 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。
2 番目のコマンドは、VM01 上の IDE バス上のセカンダリ チャネル 0 (-Bus 1 および -LUN 0 で指定) にある仮想 DVD ドライブ オブジェクトを取得し、そのオブジェクトを $DVDDrive 変数に格納します。
最後のコマンドは、$DVDDriveに格納されている仮想 DVD ドライブ オブジェクトをホスト上の物理ドライブ (D: ドライブ) に接続します。 また、他の仮想マシンがその ISO ファイルを現在使用していない場合は、仮想 DVD ドライブが以前に使用していた ISO ファイルも削除されます。
例 2: 仮想 DVD ドライブを IDE バス上の別の場所に接続する
PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM | where { $_.Bus -eq 1 -and $_.LUN -eq 0 }
PS C:\> Set-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive -Bus 1 -LUN 1
このコマンドは、VM02 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。
2 番目のコマンドは、VM02 上の IDE バス上のセカンダリ チャネル 0 (-Bus 1 および -LUN 0 で指定) にある仮想 DVD ドライブ オブジェクトを取得し、仮想 DVD ドライブ オブジェクトを$DVDDriveに格納します。
最後のコマンドは、論理ユニット番号 (LUN) を 1 に設定して、$DVDDriveに格納されている仮想 DVD ドライブ オブジェクトを IDE バス上の別の位置に接続します。
例 3: 仮想 DVD ドライブを切断する
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM | where { $_.Bus -eq 1 -and $_.LUN -eq 0 }
PS C:\> Set-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive -NoMedia
最初のコマンドは、VM03 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。
2 番目のコマンドは、VM03 上の IDE バス上のセカンダリ チャネル 0 (-Bus 1 および -LUN 0 で指定) にある仮想 DVD ドライブ オブジェクトを取得し、仮想 DVD ドライブ オブジェクトを$DVDDriveに格納します。
最後のコマンドでは、NoMedia パラメーターを使用して、$DVDDriveに格納されている仮想 DVD ドライブ オブジェクトを、接続先のホスト ドライブまたは ISO から切断します。 また、他の仮想マシンがその ISO ファイルを現在使用していない場合は、仮想 DVD ドライブが以前に使用していた ISO ファイルも削除されます。
例 4: 既存の仮想マシン上の仮想 DVD ドライブを使用可能な物理 DVD ドライブに接続する
PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> Set-SCVirtualDVDDrive -AnyVMHostDrive -VirtualDVDDrive (Get-VirtualDVDDrive -VM $VM | where {$_.Bus -eq 1 -and $_.Lun -eq 0})
最初のコマンドは、VM04 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。
最後のコマンドは、VM04 上の IDE バス上のセカンダリ チャネル (-Bus 1 と -LUN 0 で指定) の最初のスロットにある仮想 DVD ドライブ オブジェクトを取得します。 このコマンドは、AnyVMHostDrive パラメーターと共に Set-SCVirtualDVDDrive コマンドレットを使用して、仮想 DVD ドライブをホスト上の使用可能な物理 DVD ドライブに接続します。
パラメーター
-AnyVMHostDrive
仮想マシン上の仮想 DVD またはフロッピー ドライブが、ホスト上の対応する物理ドライブに接続されることを示します。 このマッピングは、格納されている仮想マシンをホストにデプロイするとき、またはテンプレートまたはハードウェア プロファイルを使用してホスト上に仮想マシンを作成してデプロイする場合に発生します。
型: | SwitchParameter |
Aliases: | AnyHostDrive |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Bus
仮想ディスク ドライブまたは仮想 DVD ドライブを接続する IDE バス、または仮想ディスク ドライブを接続する SCSI バスを指定します。
型: | Byte |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ISO
ISO オブジェクトを指定します。
型: | ISO |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | 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 |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NoMedia
仮想 DVD ドライブを、接続先のホスト ドライブまたは ISO から切断するか、仮想フロッピー ドライブを、接続先のホスト ドライブまたは仮想フロッピー ディスクから切断します。
型: | SwitchParameter |
配置: | 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 |
-SourceBus
ドライブのソース IDE バスを指定します。
型: | Byte |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SourceLUN
IDE バス上の仮想 DVD ドライブ オブジェクトのソース論理ユニット番号 (LUN) を指定します。
型: | Byte |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VirtualDVDDrive
仮想 DVD ドライブ オブジェクトを指定します。
型: | VirtualDVDDrive |
配置: | 0 |
規定値: | 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 |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
出力
VirtualDVDDrive
このコマンドレットは、VirtualDVDDrive オブジェクト
メモ
- Get-SCVirtualDVDDrive コマンドレットを使用して取得できる VMM 仮想 DVD ドライブ オブジェクトが必要です。