Get-SCStorageVolume
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 オブジェクトを返します。