Get-SCVirtualHardDisk
仮想マシン、テンプレート、または 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 コマンドレットは、仮想マシン、テンプレート、または仮想マシン マネージャー (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 は、各仮想ディスク ドライブ オブジェクトが関連付けられている仮想マシン オブジェクトまたはテンプレート オブジェクトに関係なく、すべての仮想ディスク ドライブ オブジェクトを取得します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-FamilyName
VMM ライブラリ内の物理リソースのファミリ名を指定します。 この値は、ライブラリ リソース間の等価性を確立するために、Release、Namespace、Type と組み合わせて使用されます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ID
特定のオブジェクトのグローバル一意識別子 (GUID) として数値識別子を指定します。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
VMM オブジェクトの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
| 型: | UserRole |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Release
ライブラリ リソースのリリースを記述する文字列を指定します。 VMM は、ライブラリにインポートされるすべてのリソースのリリース値を自動的に作成します。 リソースがインポートされたら、文字列をカスタマイズできます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VM
仮想マシン オブジェクトを指定します。
| 型: | VM |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VMTemplate
仮想マシンの作成に使用する VMM テンプレート オブジェクトを指定します。
| 型: | Template |
| Aliases: | Template |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
VirtualHardDisk
このコマンドレットは、VirtualHardDisk オブジェクトを返します。
メモ
- Get-SCVirtualMachine コマンドレットまたは Get-SCVMTemplate コマンドレットを使用して取得できる VMM 仮想マシン オブジェクトまたは VMM テンプレート オブジェクトが必要です。