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: ドライブ) に接続します。 また、仮想 DVD ドライブがそれまで使用していた ISO ファイルを他の仮想マシンが現在使用していない場合は、その 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 から切断します。 また、仮想 DVD ドライブがそれまで使用していた ISO ファイルを他の仮想マシンが現在使用していない場合は、その 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 ドライブ オブジェクトを取得します。 このコマンドは 、Set-SCVirtualDVDDrive コマンドレットと AnyVMHostDrive パラメーターを使用して、仮想 DVD ドライブをホスト上の使用可能な物理 DVD ドライブに接続します。
パラメーター
-AnyVMHostDrive
仮想マシン上の仮想 DVD またはフロッピー ドライブが、ホスト上の対応する物理ドライブに接続されることを示します。 このマッピングは、ホストに格納されている仮想マシンをデプロイするとき、またはテンプレートまたはハードウェア プロファイルを使用してホスト上に仮想マシンを作成してデプロイする場合に発生します。
Type: | SwitchParameter |
Aliases: | AnyHostDrive |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Bus
仮想ディスク ドライブやバーチャル DVD ドライブの接続先となる IDE バス、または仮想ディスク ドライブの接続先となる SCSI バスを指定します。
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ISO
ISO オブジェクトを指定します。
Type: | ISO |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 ドライブ オブジェクト、または SCSI バス上の仮想ディスク ドライブ オブジェクトの論理ユニット番号 (LUN) を指定します。
- 形式の例:
-IDE -Bus 1 -LUN 0
- 形式の例:
-SCSI -Bus 0 -LUN 1
Type: | Byte |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoMedia
バーチャル DVD ドライブを接続されていたホスト ドライブまたは ISO から切断したり、バーチャル フロッピー ドライブを接続されていたホスト ドライブまたはバーチャル フロッピー ディスクから切断したりします。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されたユーザーの代わりに動作します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを 使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールの代わりに動作します。
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、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 |
-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: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
出力
VirtualDVDDrive
このコマンドレットは 、VirtualDVDDrive オブジェクトを返します。
メモ
- Get-SCVirtualDVDDrive コマンドレットを使用して取得できる VMM 仮想 DVD ドライブ オブジェクトが必要です。