MSFT_StoragePool クラス

[アーティクル]
04/01/2024

仮想ディスクの作成に使用できる物理ディスクの論理グループを表します。

仮想ディスクは、使用可能な物理ディスクの数とストレージプールの機能に基づいて、さまざまな特性と回復性レベルで作成できます。

次の構文は、Managed Object Format (MOF) コードをシンプルにしたものです。

構文

class MSFT_StoragePool : MSFT_StorageObject
{
  String  FriendlyName;
  String  Name;
  UInt16  Usage;
  String  OtherUsageDescription;
  Boolean IsPrimordial;
  UInt16  HealthStatus;
  UInt16  OperationalStatus[];
  String  OtherOperationalStatusDescription;
  UInt64  Size;
  UInt64  AllocatedSize;
  UInt64  LogicalSectorSize;
  UInt64  PhysicalSectorSize;
  UInt16  ProvisioningTypeDefault;
  UInt16  SupportedProvisioningTypes[];
  String  ResiliencySettingNameDefault;
  Boolean IsReadOnly;
  UInt16  ReadOnlyReason;
  Boolean IsClustered;
  Boolean SupportsDeduplication;
  UInt16  ThinProvisioningAlertThresholds[];
  Boolean ClearOnDeallocate;
  Boolean IsPowerProtected;
  UInt16  RepairPolicy;
  Boolean EnclosureAwareDefault;
  UInt16  FaultDomainAwarenessDefault;
  UInt16  RetireMissingPhysicalDisks;
  UInt16  Version;
  UInt64  WriteCacheSizeDefault;
  UInt64  WriteCacheSizeMin;
  UInt64  WriteCacheSizeMax;
};

メンバー

MSFT_StoragePool クラスには、次の種類のメンバーがあります。

メソッド
プロパティ

メソッド

MSFT_StoragePool クラスには、次のメソッドがあります。

Method	説明
AddPhysicalDisk	ストレージプールに物理ディスクを追加します。
CreateStorageTier	ストレージプールにストレージ層テンプレートを作成します。
CreateVirtualDisk	ストレージプール内に仮想ディスクを作成します。
CreateVolume	ストレージプールのリソースを使用して、仮想ディスクと単一ボリュームを作成します。
DeleteObject	空のストレージプールを削除します。
GetSecurityDescriptor	ストレージプールオブジェクトインスタンスのセキュリティ記述子を取得します。
GetSupportedSize	ストレージプールに作成できるサポートされている仮想ディスクサイズを取得します。
最適化	ストレージプールを最適化します。
RemovePhysicalDisk	ストレージプールから物理ディスクを削除します。
SetAttributes	ストレージプールオブジェクトの属性値を設定または変更します。
SetDefaults	ストレージプールオブジェクトのプロパティの既定値を設定または変更します。
SetFriendlyName	ストレージプールオブジェクトのフレンドリ名を設定または変更します。
SetSecurityDescriptor	ストレージプールオブジェクトのセキュリティ記述子を設定または変更します。
SetUsage	ストレージプールオブジェクトの使用目的を設定または変更します。
アップグレード	ストレージプールのメタデータをアップグレードします。

プロパティ

MSFT_StoragePool クラスには、これらのプロパティがあります。

AllocatedSize

データ型: UInt64

アクセスの種類: 読み取り専用

修飾子: Units ("バイト")

このストレージプールで使用される合計容量。プールがプリモディアルの場合、これはコンクリートストレージプールに現在割り当てられているすべての容量の合計になります。プールがコンクリートの場合、この値は、仮想ディスクとその他のプールメタデータに現在割り当てられているすべての容量の合計である必要があります。

ClearOnDeallocate

データ型: Boolean

アクセスの種類: 読み取り専用

ストレージプールのマップ解除または削除時に、物理ディスクをゼロにする (すべてのデータをクリアする) 必要がある場合は、TRUE です。

EnclosureAwareDefault

データ型: Boolean

アクセスの種類: 読み取り専用

このプールに作成された仮想ディスクの既定の割り当て動作。エンクロージャ対応の仮想ディスクは、冗長性のために使用する物理ディスクをインテリジェントに選択します。 TRUE の場合、仮想ディスクは異なるエンクロージャの物理ディスクを使用して、2 つ以上の物理エンクロージャ間のフォールトトレランスのバランスを取ります。

FaultDomainAwarenessDefault

データ型: UInt16

アクセスの種類: 読み取り専用

このプールに作成された仮想ディスクの既定の割り当て動作を決定します。障害ドメイン対応仮想ディスクは、冗長性のために使用する物理ディスクをインテリジェントに選択して、指定された種類の 2 つ (またはそれ以上) の障害ドメインユニット間でフォールトトレランスのバランスを取ります。

PhysicalDisk (1)

StorageEnclosure (2)

StorageScaleUnit (3)

StorageChassis (4)

StorageRack (5)

FriendlyName

データ型: String

アクセスのタイプ: 読み取り/書き込み

修飾子: 必須

ストレージプールのユーザーフレンドり名。この名前は、 SetFriendlyName メソッドを呼び出すことによって設定できます。

HealthStatus

データ型: UInt16

アクセスの種類: 読み取り専用

修飾子: 必須

ストレージプールの正常性状態。

ストレージプールの正常性は、バッキング物理ディスクの正常性と、ストレージプールが必要な冗長性レベルを維持できるかどうかから派生します。

Value	意味
Healthy 0	すべての物理ディスクが存在し、正常な状態です。
Warning 1	大部分の物理ディスクは正常ですが、1 つ以上の I/O 要求が失敗している可能性があります。
Unhealthy 2	大部分の物理ディスクが異常または障害状態であり、ストレージプールのデータ整合性がなくなりました。
Unknown 5	ストレージプールの正常性状態が不明です。

IsClustered

データ型: Boolean

アクセスの種類: 読み取り専用

ストレージプールがクラスター環境で使用されている場合は、TRUE です。

IsPowerProtected

データ型: Boolean

アクセスの種類: 読み取り専用

このプール内のディスクが、データ損失なしで電力損失に耐えられる場合は、TRUE です。たとえば、外部電源が切断された後、揮発性バッファーを自動的に不揮発性メディアにフラッシュします。

IsPrimordial

データ型: Boolean

アクセスの種類: 読み取り専用

修飾子: 必須

このフィールドが TRUE に設定された場合、ストレージプールはプリモディアルです。 "使用可能ストレージ" プールとも呼ばれるプリモディアルプールでは、コンクリートストレージプールの作成と削除でストレージ容量が描画され、返されます。プリモディアルプールを作成または削除することはできません。

このフィールドが FALSE に設定された場合、ストレージプールはコンクリートプールです。これらのプールは、仮想ディスクの作成と削除を含め、ストレージプールクラスで定義されているすべての管理操作の対象となります。

IsReadOnly

データ型: Boolean

アクセスの種類: 読み取り専用

ストレージプールの構成が読み取り専用かどうかを示します。 TRUE の場合、ストレージプールはそれ自体の変更またはその仮想および物理ディスクの変更はできません。このプロパティが TRUE の場合でも、仮想ディスク上のデータは書込み可能な場合があることに注意してください。

LogicalSectorSize

データ型: UInt64

アクセスの種類: 読み取り専用

修飾子: Units ("バイト")

ストレージプールの論理セクターサイズ (バイト単位)。この値は、バッキング物理ディスクと、このストレージプールの作成時に指定された基本設定から派生する必要があります。

名前

データ型: 文字列

アクセスの種類: 読み取り専用

修飾子: 必須

半一意 (所有するストレージサブシステムを範囲とする) の、ストレージプールの識別に使用される人間が判読できる文字列。

OperationalStatus

データ型: UInt16 配列

アクセスの種類: 読み取り専用

修飾子: 必須

ストレージプールの動作状態。 HealthStatus とは異なり、このプロパティは、ストレージプールに関連するハードウェア、ソフトウェア、インフラストラクチャの問題の状態を示し、複数の値を含むことがあります。

Value	意味
不明 0	動作状態が不明です。
その他 1	ベンダー固有の OperationalStatus は、 OtherOperationalStatusDescription プロパティを設定することによって指定されます。
OK 2	ストレージプールはコマンドに応答しており、通常の動作状態です。
Degraded 3	ストレージプールはコマンドに応答していますが、最適な動作状態で実行しているわけではありません。
Stressed 4	ストレージプールは機能していますが、注意が必要です。たとえば、ストレージサブシステムが過負荷または過熱状態になる場合があります。
Predictive Failure 5	ストレージプールは機能していますが、近い将来の障害を予測しています。
Error 6	エラーが発生しました。
回復不能エラー 7	回復不可能なエラーが発生しました。
開始中 8	ストレージプールは開始中です。
Stopping 9	ストレージプールは停止中です。
Stopped 10	ストレージプールは、クリーンで順序正しく停止しました。
In Service 11	ストレージプールは、構成、保守、クリーニング、または管理中です。
No Contact 12	ストレージプロバイダーはストレージプールに関する知識を持っていますが、ストレージプロバイダーとの通信を確立できませんでした。
Lost Communication 13	ストレージプロバイダーはストレージプールに関する知識を持ち、過去に正常に接続しましたが、ストレージサブシステムに現在到達できません。
Aborted 14	停止と同様に、ストレージプールが突然停止し、構成または保守が必要な場合があります。
Dormant 15	ストレージプールに到達できますが、非アクティブです。
Supporting Entity in Error 16	この状態値は、必ずしもストレージプールの問題を示しているわけではありませんが、ストレージプールが依存している別のデバイスまたは接続に注意が必要な場合があることを示します。
Completed 17	ストレージプールが操作を完了しました。この状態値は、操作の結果に応じて、 OK、 Error、または Degraded と組み合わせる必要があります。
パワーモード 18	この値は、システム使用のために予約されています。
Relocating 19	ストレージプールは再配置中です。
Microsoft 予約済み ..	この値は、システム使用のために予約されています。
Majority Disks Unhealthy 0x8000	この値は、システム使用のために予約されています。
Minority Disks Unhealthy 0x8001	この値は、システム使用のために予約されています。
Microsoft 予約済み 0x8002..	この値は、システム使用のために予約されています。

OtherOperationalStatusDescription

データ型: String

アクセスの種類: 読み取り専用

ベンダーが定義した状態の文字列形式。このプロパティは、 OperationalStatus プロパティの値が Other の場合のみ設定する必要があります。

OtherUsageDescription

データ型: String

アクセスの種類: 読み取り専用

ストレージプールについてベンダーが定義した使用法の文字列表現。このプロパティは、 Usage プロパティが Other に設定された場合にのみ指定できます。

PhysicalSectorSize

データ型: UInt64

アクセスの種類: 読み取り専用

修飾子: Units ("バイト")

物理セクターサイズ (バイト単位)。この値は、ストレージプールに属するバッキング物理ディスクから派生します。

ProvisioningTypeDefault

データ型: UInt16

アクセスの種類: 読み取り専用

修飾子: 必須

ストレージプールに新しい仮想ディスクを作成するときに使用する既定のプロビジョニングスキーム。

Value	意味
Unknown 0	割り当てポリシーが不明です。これは、この情報が使用できないか、またはストレージプールが独自の割り当て方法を使用していることを意味する可能性があります。
Thin 1	仮想ディスクのストレージは、オンデマンドで割り当てられます。
Fixed 2	仮想ディスクのストレージは、仮想ディスクの作成時に割り当てられます。

ReadOnlyReason

データ型: UInt16

アクセスの種類: 読み取り専用

ストレージプールが読み取り専用である理由。

Value	意味
Unknown 0	理由は不明です。
None 1	プールは読み取り専用ではありません。
By Policy 2	管理者がプールを読み取り専用にすることを要求したか、プールを読み取り専用にする必要があるポリシーをシステムに適用しました。
Majority Disks Unhealthy 3	サポートされている物理ディスクの大部分が異常な状態であり、ストレージプールは読み取り専用の状態になっています。

RepairPolicy

データ型: UInt16

アクセスの種類: 読み取り専用

オペレーティングシステムがこのストレージプールの仮想ディスクを修復する方法。

Value	意味
2	シーケンシャル - 一度に 1 つの割り当てスラブを処理します。修復にかかる時間は長くなりますが、I/O 負荷への影響は少なくなります。
3	並列 - できるだけ多くの割り当てスラブを並列に処理します。修復時間は最小限に抑えられますが、I/O 負荷に大きな影響を与えます。

ResiliencySettingNameDefault

データ型: String

アクセスの種類: 読み取り専用

修飾子: 必須、 ModelCorrespondence {{"MSFT_ResiliencySetting.Name"}}

ストレージプールに新しい仮想ディスクを作成するときに既定で使用する必要がある回復性設定。この既定値は、仮想ディスクの作成時にオーバーライドできます。このプロパティの値は、 MSFT_ResiliencySetting オブジェクトの Name プロパティに対応する必要があります。

RetireMissingPhysicalDisks

データ型: UInt16

アクセスの種類: 読み取り専用

修飾子: Values ( "Auto", "Always", "Never" ), ValueMap ("1", "2", "3")

ストレージサブシステムが、このストレージプールに存在しない物理ディスクを自動的にインベントリから削除し、ホットスペアまたはストレージプールで使用可能な他の物理ディスクに置き換えるかどうかを指定します。

[サイズ]

データ型: UInt64

アクセスの種類: 読み取り専用

修飾子: Units ("バイト")

ストレージプールの容量。プールがプリモディアルの場合、これはすべての正常な物理ディスクサイズの合計です。プールがコンクリートの場合、これは関連付けられているすべての物理ディスクの合計です (ホットスペアを除き、障害が発生したドライブも含まれます)。

SupportedProvisioningTypes

データ型: UInt16 配列

アクセスの種類: 読み取り専用

修飾子: 必須

ストレージプールが仮想ディスクを作成するためにサポートするプロビジョニングスキーム。

Value	意味
Unknown 0	割り当てポリシーが不明です。これは、この情報が使用できないか、またはストレージプールが独自の割り当て方法を使用していることを意味する可能性があります。
Thin 1	仮想ディスクのストレージは、オンデマンドで割り当てられます。
Fixed 2	仮想ディスクのストレージは、仮想ディスクの作成時に割り当てられます。

SupportsDeduplication

データ型: Boolean

アクセスの種類: 読み取り専用

ストレージプールがデータ重複除去をサポートしている場合は TRUE です。

ThinProvisioningAlertThresholds

データ型: UInt16 配列

アクセスの種類: 読み取り専用

修飾子: Units ("Percentage"), MinValue (0), MaxValue (100)

さまざまなスパース (仮想プロビジョニング) しきい値を表すパーセンテージ値の配列。仮想ディスク領域の使用量がこれらのしきい値のいずれかを超えると、サブスクライブしているすべてのクライアントに通知がブロードキャストされます。

使用方法

データ型: UInt16

アクセスの種類: 読み取り専用

修飾子: 必須

ストレージプールの使用目的。

定義済みの説明またはカスタムの説明を指定できます。定義済みの説明を指定するには、 Other 以外の値を使用します。

カスタムの説明を指定するには、 Other を使用し、 OtherUsageDescription プロパティとして NULL 以外の値を指定します。

Unknown (0)

Other (1)

Unrestricted (2)

Reserved for ComputerSystem (the block server) (3)

Reserved as a Delta Replica Container (4)

Reserved for Migration Services (5)

Reserved for Local Replication Services (6)

Reserved for Remote Replication Services (7)

Reserved for Sparing (8)

Version

データ型: UInt16

アクセスの種類: 読み取り専用

このストレージプールをサポートする最小 OS バージョン。

Value	意味
1	Windows Server 2012
2	Windows Server 2012 R2 Preview
3	Windows Server 2012 R2

WriteCacheSizeDefault

データ型: UInt64

アクセスの種類: 読み取り専用

仮想ディスク作成用の書き込みキャッシュの既定のサイズ。

WriteCacheSizeMax

データ型: UInt64

アクセスの種類: 読み取り専用

仮想ディスク作成用の書き込みキャッシュの最大サイズ。

WriteCacheSizeMin

データ型: UInt64

アクセスの種類: 読み取り専用

仮想ディスク作成用の書き込みキャッシュの最小サイズ。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリのみ]
名前空間	Root\Microsoft\Windows\Storage
MOF	Storagewmi.mof

次の方法で共有

MSFT_StoragePool クラス

構文

メンバー

メソッド

プロパティ

要件

フィードバック

その他のリソース