Get-SCStorageVolume

  • リファレンス
モジュール:
VirtualMachineManager

VMM によって管理されるホストからストレージ ボリューム オブジェクトを取得します。

構文

Get-SCStorageVolume
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCStorageVolume
   -LibraryServer <LibraryServer>
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCStorageVolume
   -StorageArray <StorageArray>
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCStorageVolume
   -VMHost <Host>
   [[-Name] <String>]
   [<CommonParameters>]

説明

Get-SCStorageVolume コマンドレットは、Virtual Machine Manager (VMM) によって管理されるホストから 1 つ以上のストレージ ボリューム オブジェクトを取得します。

返される情報には、次のものが含まれますが、これらに限定されません。

  • 名前。 各ホスト ボリュームの名前 (C:、D:、E:\など)。

  • StorageVolumeID。 各ホスト ボリュームのボリューム ID (GUID)。 ホスト ボリューム ID は、VMM 環境全体で一意です。

  • MountPoints。 各ボリュームのマウント ポイント。 C: などの 1 つのボリュームには、複数のマウント ポイントを含めることができます。

  • 容量。 各ボリュームのストレージ容量。

  • Freespace。 各ボリュームの空き領域の量。

  • VolumeLabel。 このボリュームのユーザー定義ラベル (存在する場合)。

  • IsSANMigrationPossible。 SAN 移行が使用可能かどうかを示すフラグ。

  • IsClustered - ボリュームがローカル ストレージか共有ストレージか (つまり、SAN や iSCSI などの外部ストレージを使用する) かを示すフラグで、このボリュームにクラスター化されたディスク リソースが存在します。

  • InUse。 VMM で管理されている高可用性仮想マシンのいずれかがこのボリュームを使用している場合に True に設定されるフラグ。

  • VMHost。 各ボリュームが存在するホストの FQDN 名。

  • IsAvailableForPlacement。 このボリュームが、このホストに仮想マシンをデプロイする場所として使用できるかどうかを示すフラグ。

  • ServerConnection。 このボリュームが属するホストを管理している VMM サーバー接続。

  • ID。 各ボリュームの ID (GUID)。

例

例 1: 指定したホスト サーバー上のすべてのボリュームを取得する

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> Get-SCStorageVolume -VMHost $VMHost

最初のコマンドは、VMHost01 という名前のホスト オブジェクトを取得し、そのオブジェクトを $VMHost 変数に格納します。

2 番目のコマンドは、VMHost01 からすべてのドライブ ボリューム オブジェクトを取得し、これらのボリュームに関する情報をユーザーに表示します。

注: 容量と空き領域をバイトからより大きな測定単位に変換するには、バイト数を 1024 で除算してキロバイト (KB) を取得します。結果を 1024 で除算してメガバイト (MB) を取得します。その結果を 1024 で除算してギガバイト (GB) を取得します。

例 2: ホストで指定されたボリュームを取得する

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02.Contoso.com" 
PS C:\> Get-SCStorageVolume -VMHost $VMHost -Name "C:\"

最初のコマンドは、VMHost02 という名前のホスト オブジェクトを取得し、そのオブジェクトを $VMHost 変数に格納します。

2 番目のコマンドは、C:\ という名前のドライブ ボリュームを取得します。VMHost02 からこのボリュームに関する情報をユーザーに表示します。

例 3: ボリューム名に "SharedStorage" という文字列を含む VMware ESX ホスト上のすべてのボリュームを取得する

PS C:\> $VMHost = Get-SCVMHost -VMMServer "VMMServer01.Contoso.com" | where { $_.VirtualizationPlatform -eq "VMwareESX" }
PS C:\> $VMHost | Get-SCStorageVolume | select -Property Name, VMHost | where { $_.Name -match "SharedStorage" }

最初のコマンドは VMMServer01 からすべてのホスト オブジェクトを取得し、仮想化プラットフォームが VMware ESX であるホスト オブジェクトのみを選択し、そのホスト オブジェクトを$VMHostに格納します。

注: この例では、これらの ESX サーバー上のすべてのボリュームの名前に文字列 "storage" が含まれているが、それらのボリュームの名前の一部にのみ文字列 "SharedStorage" が含まれているものとします。

2 番目のコマンドは、$VMHost内の各 ESX ホスト オブジェクトを Get-SCStorageVolume コマンドレットに渡し、これらのホスト上のボリューム オブジェクトを取得し、ボリューム オブジェクトを "select" ( Select-Object コマンドレットのエイリアス) に渡します。 Select-Object コマンドレットには、"SharedStorage" という文字列を含むボリュームのボリューム名と、ボリュームが存在するホストが表示されます。

パラメーター

-LibraryServer

VMM ライブラリ サーバー オブジェクトを指定します。

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

-Name

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

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

-StorageArray

ストレージ 配列オブジェクトを指定します。 これは、仮想マシンの構成と仮想ディスクの格納に使用されるファイバー チャネルまたは iSCSI ストレージ サブシステムです。

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

-VMHost

仮想マシン ホスト オブジェクトを指定します。 VMM では、Hyper-V ホスト、VMware ESX ホスト、Citrix XenServer ホストがサポートされています。

ホストの種類の詳細については、 Add-SCVMHost コマンドレットを参照してください。

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

出力

StorageVolume

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