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

コピーする代わりにリソースをリンクする必要があることを示します。

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 ドライブ オブジェクトが必要です。