Get-SCVirtualHardDisk

モジュール:

VirtualMachineManager

仮想マシンから、テンプレートから、または VMM ライブラリに格納されているスタンドアロン ファイルとして仮想ハード ディスク オブジェクトを取得します。

構文

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -Name <String>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-Release <String>]
   -FamilyName <String>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Get-SCVirtualHardDisk コマンドレットは、仮想マシン、テンプレート、または Virtual Machine Manager (VMM) ライブラリに格納されているスタンドアロン ファイルとして仮想ハード ディスク オブジェクトを取得します。

仮想ハード ディスクには、Windows ベースの .vhd ファイル、Citrix XenServer ベースの .vhd ファイル、または VMware ベースの .vmdk ファイルを指定できます。 仮想ハード ディスクは、VMM ライブラリにスタンドアロン オブジェクトとして格納されるか、テンプレート上の仮想ディスク ドライブに接続されるか、デプロイまたは格納された仮想マシン上の仮想ディスク ドライブに接続されている可能性があります。

例

例 1: ライブラリから仮想ハード ディスク オブジェクトを取得する

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }

このコマンドは、LibraryServer01 に格納されている VHD01.vhd という名前の仮想ハード ディスク オブジェクトを取得し、そのオブジェクトを $VHD 変数に格納します。

例 2: 仮想マシンから仮想ハード ディスク オブジェクトを取得する

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }

最初のコマンドは VMMServer01 に接続します。

2 番目のコマンドは、VM01 という名前の仮想マシン オブジェクトを取得し、その名前に "DataDisk" という文字列が含まれる VM01 上のすべての仮想ハード ディスクを選択し、返された仮想ハード ディスク オブジェクトを $VHD 変数に格納します。

例 3: 特定のテンプレートから仮想ハード ディスク オブジェクトを取得する

PS C:\> Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "Template01"} | Get-SCVirtualHardDisk

このコマンドは、ライブラリから Template01 という名前のテンプレート オブジェクトを取得し、そのテンプレート上のすべての仮想ハード ディスク オブジェクトを表示します。

パラメーター

-All

このコマンドレットは、親オブジェクトに関係なくすべての下位オブジェクトを取得することを示します。 たとえば、コマンドは、各仮想ディスク ドライブ オブジェクトが関連付けられている仮想マシン オブジェクトまたはテンプレート オブジェクトに関係なく、すべての仮想ディスク ドライブ オブジェクトを取得します Get-SCVirtualDiskDrive -All 。

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

-FamilyName

VMM ライブラリ内の物理リソースのファミリ名を指定します。 この値は、ライブラリ リソース間の等価性を確立するために、Release、Namespace、Type と組み合わせて使用されます。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ID

特定のオブジェクトのグローバル一意識別子 (GUID) として数値識別子を指定します。

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

VMM オブジェクトの名前を指定します。

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

-Release

ライブラリ リソースのリリースを記述する文字列を指定します。 VMM は、ライブラリにインポートされたすべてのリソースのリリース値を自動的に作成します。 リソースがインポートされたら、文字列をカスタマイズできます。

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

出力

VirtualHardDisk

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

メモ

• それぞれ Get-SCVirtualMachine コマンドレットまたは Get-SCVMTemplate コマンドレットを使用して取得できる VMM 仮想マシン オブジェクトまたは VMM テンプレート オブジェクトが必要です。

関連リンク

• Compress-SCVirtualDiskDrive
• Get-SCVirtualDiskDrive
• Get-SCVirtualMachine
• Get-SCVMTemplate
• Remove-SCVirtualHardDisk
• Set-SCVirtualDiskDrive
• Set-SCVirtualHardDisk