Get-SCVirtualDVDDrive
仮想マシン、仮想マシン テンプレート、またはハードウェア プロファイルから VMM 仮想 DVD ドライブ オブジェクトを取得します。
構文
Get-SCVirtualDVDDrive
[-VMMServer <ServerConnection>]
[-All]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Get-SCVirtualDVDDrive
[-VMMServer <ServerConnection>]
-HardwareProfile <HardwareProfile>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Get-SCVirtualDVDDrive
[-VMMServer <ServerConnection>]
-VM <VM>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Get-SCVirtualDVDDrive
[-VMMServer <ServerConnection>]
-VMTemplate <Template>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Get-SCVirtualDVDDrive
[-VMMServer <ServerConnection>]
[-ID] <Guid>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
説明
Get-SCVirtualDVDDrive コマンドレットは、仮想マシン オブジェクト、仮想マシン テンプレート オブジェクト、またはハードウェア プロファイル オブジェクトから 1 つ以上の Virtual Machine Manager (VMM) 仮想 DVD ドライブ オブジェクトを取得します。
例
例 1: 仮想マシンから仮想 DVD ドライブを取得する
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualDVDDrive -VM $VM
最初のコマンドは、VM01 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。
2 番目のコマンドは、VM01 上のすべての DVD ドライブ オブジェクトを取得し、これらの仮想 DVD ドライブに関する情報をユーザーに表示します。
例 2: テンプレートから仮想 DVD ドライブを取得する
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualDVDDrive -Template $VMTemplate
最初のコマンドは、VMM ライブラリに格納されているすべての仮想マシン テンプレート オブジェクトを取得し、VMTemplate01 という名前のテンプレート オブジェクトを選択してから、$Template変数にオブジェクトを格納します。
2 番目のコマンドは、VMTemplate01 上のすべての仮想 DVD ドライブ オブジェクトを取得し、これらの仮想 DVD ドライブに関する情報をユーザーに表示します。
例 3: ハードウェア プロファイルから仮想 DVD ドライブを取得する
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualDVDDrive -HardwareProfile $HWProfile
最初のコマンドは、VMM ライブラリ内のすべてのハードウェア プロファイル オブジェクトを取得し、NewHWProfile01 という名前のプロファイル オブジェクトを選択し、そのオブジェクトを $HWProfile 変数に格納します。
2 番目のコマンドは、NewHHWProfile01 上のすべての仮想 DVD ドライブ オブジェクトを取得し、これらの仮想 DVD ドライブに関する情報をユーザーに表示します。
パラメーター
-All
このコマンドレットは、親オブジェクトに関係なくすべての下位オブジェクトを取得することを示します。
たとえば、コマンドは、各仮想ディスク ドライブ オブジェクトが関連付けられている仮想マシン オブジェクトまたはテンプレート オブジェクトに関係なく、すべての仮想ディスク ドライブ オブジェクトを取得します Get-SCVirtualDiskDrive -All
。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HardwareProfile
ハードウェア プロファイル オブジェクトを指定します。
Type: | HardwareProfile |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ID
特定のオブジェクトのグローバル一意識別子 (GUID) として数値識別子を指定します。
Type: | Guid |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 |
-VM
仮想マシン オブジェクトを指定します。
Type: | VM |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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-SCVirtualMachine、 Get-SCVMTemplate、または Get-SCHardwareProfile コマンドレットを使用して取得できます。