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 ドライブを VMTemplate01 に作成し、テンプレートを使用して仮想マシンを作成するときに、IDE バスのセカンダリ チャネル (1) に仮想 DVD ドライブを接続します。

例 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 文字列を作成し、GUID 文字列を変数 $JobGroupID に保管します。 この GUID はジョブ グループ ID で、この ID とそれ以降のコマンドを 1 つのジョブ グループにまとめる識別子の役割を果たします。

2 番目のコマンドは、新しいバーチャル DVD ドライブ オブジェクトを作成し、この新しいバーチャル DVD ドライブで任意の使用可能な物理 DVD ドライブを使用できることを指定します。 このコマンドは、新しいバーチャル DVD ドライブを 2 番目の IDE チャネルの 1 番目のスロットに接続します (バーチャル DVD ドライブを接続できるバスの種類は IDE のみです)。 ジョブ グループ 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 またはフロッピー ドライブが、ホスト上の対応する物理ドライブに接続されることを示します。 このマッピングは、ホストに格納されている仮想マシンをデプロイするとき、またはテンプレートまたはハードウェア プロファイルを使用してホスト上に仮想マシンを作成してデプロイする場合に発生します。

Type:SwitchParameter
Aliases:AnyHostDrive
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Bus

仮想ディスク ドライブやバーチャル DVD ドライブの接続先となる IDE バス、または仮想ディスク ドライブの接続先となる 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

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

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: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

-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

このコマンドレットは 、VirtualDVDDrive オブジェクトを返します。

メモ

  • VMM 仮想マシン オブジェクト、仮想マシン テンプレート オブジェクト、またはハードウェア プロファイル オブジェクトが必要です。 これらのオブジェクトは、 それぞれ Get-SCVirtualMachineGet-SCVMTemplate、または Get-SCHardwareProfile コマンドレットを使用して取得できます。