MSFT_VirtualDisk クラス
サブシステム ストレージ ボリュームを表します。
次の構文は、Managed Object Format (MOF) コードをシンプルにしたものです。
構文
class MSFT_VirtualDisk : MSFT_StorageObject
{
String FriendlyName;
String Name;
UInt16 NameFormat;
UInt16 UniqueIdFormat;
String UniqueIdFormatDescription;
UInt16 Usage;
String OtherUsageDescription;
UInt16 HealthStatus;
UInt16 OperationalStatus[];
String OtherOperationalStatusDescription;
String ResiliencySettingName;
UInt64 Size;
UInt64 AllocatedSize;
UInt64 LogicalSectorSize;
UInt64 PhysicalSectorSize;
UInt64 FootprintOnPool;
UInt16 ProvisioningType;
UInt16 NumberOfDataCopies;
UInt16 PhysicalDiskRedundancy;
UInt16 ParityLayout;
UInt16 NumberOfColumns;
UInt64 Interleave;
Boolean RequestNoSinglePointOfFailure;
UInt16 Access;
Boolean IsSnapshot;
Boolean IsManualAttach;
Boolean IsDeduplicationEnabled;
Boolean IsEnclosureAware;
UInt16 NumberOfAvailableCopies;
UInt16 DetachedReason;
UInt64 WriteCacheSize;
};
メンバー
MSFT_VirtualDisk クラスには、次の種類のメンバーがあります。
メソッド
MSFT_VirtualDisk クラスには、次のメソッドがあります。
| Method | 説明 |
|---|---|
| AddPhysicalDisk | 手動割り当て用に 1 つ以上の物理ディスクを追加します。 |
| [アタッチ] | 仮想ディスクをアタッチします。 |
| CreateClone | 既存の仮想ディスクのクローンである新しい仮想ディスクを作成します。 |
| CreateReplica | 仮想ディスク間のレプリケーション関係を作成します。 |
| CreateSnapshot | 仮想ディスクのクローンを作成し、元の仮想ディスクと同じデータを持つ新しい仮想ディスクを作成します。 |
| DeleteObject | 仮想マシンを削除します。 |
| [デタッチ] | 仮想ディスクをデタッチします。 |
| GetSecurityDescriptor | 仮想ディスク オブジェクト インスタンスへのアクセスを制御するセキュリティ記述子を取得します。 |
| 非表示 | 仮想ディスクを非表示にします。 |
| RemovePhysicalDisk | 手動割り当てから 1 つ以上の物理ディスクを削除します。 |
| Repair | 仮想ディスクの修復を開始し、ストレージ プール内の異なる (または新しい) 物理ディスクにデータと冗長性を復元します。 |
| サイズ変更 | 仮想ディスクのサイズを変更します。 |
| SetAttributes | 仮想ディスクのさまざまな属性を設定または更新します。 |
| SetFriendlyName | 仮想ディスクのフレンドリ名を設定します。 |
| SetReplicationRelationship | 仮想ディスク間のレプリケーション関係を設定します。 |
| SetSecurityDescriptor | 仮想ディスク オブジェクト インスタンスへのアクセスを制御するセキュリティ記述子を設定します。 |
| SetUsage | 仮想ディスクの使用目的を設定します。 |
| 表示 | 仮想ディスクを公開します。 |
プロパティ
MSFT_VirtualDisk クラスには、次のプロパティがあります。
アクセス
データ型: UInt16
アクセスの種類: 読み取り専用
仮想ディスクが読み取りおよび書き込みアクセスに使用できるかどうかを示します。
Unknown (0)
Readable (1)
Writeable (2)
Read/Write (3)
Write Once (4)
AllocatedSize
データ型: UInt64
アクセスの種類: 読み取り専用
修飾子: Required, Units ("Bytes")
現在割り当てられている仮想ディスクのサイズ。 仮想ディスクの ProvisioningType が Fixed の場合、AllocatedSize は Size に等しい必要があります。 ProvisioningType が Thin の場合、この値は、実際に割り当てられたスペースの量です (Size 未満である必要があります)。
DetachedReason
データ型: UInt16
アクセスの種類: 読み取り専用
この仮想ディスクがデタッチされた理由。 このプロパティは、仮想ディスクの OperationalStatus が Detached を含むときにのみ設定されます。 このフィールドはストレージ スペースに固有であることに注意してください。
Unknown (0)
None (1)
By Policy (2)
Majority Disks Unhealthy (3)
Incomplete (4)
FootprintOnPool
データ型: UInt64
アクセスの種類: 読み取り専用
修飾子: Units ("バイト")
この仮想ディスクによって消費されているストレージ プールの合計容量 (バイト単位)。 たとえば、サイズが 1 GB の 2 方向ミラー化仮想ディスクの場合、プール内のフットプリントは約 2 GB になります。
FriendlyName
データ型: 文字列
アクセスの種類: 読み取り専用
修飾子: 必須
仮想ディスクの名前を含む、ユーザー設定可能な表示指向の文字列。
HealthStatus
データ型: UInt16
アクセスの種類: 読み取り専用
修飾子: 必須
仮想ディスクの正常性状態。
仮想ディスクの正常性は、バッキング物理ディスクの正常性と、仮想ディスクが必要なレベルの回復性を維持できるかどうかから派生します。
| Value | 意味 |
|---|---|
| Healthy 0 | すべての物理ディスクが存在し、正常な状態です。 |
| Warning 1 | 大部分の物理ディスクは正常ですが、1 つ以上の I/O 要求が失敗している可能性があります。 |
| Unhealthy 2 | 大部分の物理ディスクが異常または障害状態であり、仮想ディスクのデータ整合性がなくなりました。 |
| Unknown 5 | 正常性状態が不明です。 |
Interleave
データ型: UInt64
アクセスの種類: 読み取り専用
一般的なストライピングベースの回復性設定でストリップの形成に必要なバイト数。 ストリップは、1 つの物理ディスク上にあるストライプの部分のサイズとして定義されます。 したがって、Interleave * NumberOfColumns はユーザーデータの 1 つのストライプのサイズになります。
IsDeduplicationEnabled
データ型: Boolean
アクセスのタイプ: 読み取り/書き込み
仮想ディスクに対するデータ重複除去が有効な場合は、TRUE。
IsEnclosureAware
データ型: Boolean
アクセスの種類: 読み取り専用
この仮想ディスクの現在の割り当て動作。 エンクロージャ対応の仮想ディスクは、冗長性のために使用する物理ディスクをインテリジェントに選択します。 TRUE の場合、仮想ディスクは異なるエンクロージャの物理ディスクを使用して、2 つ以上の物理エンクロージャ間のフォールト トレランスのバランスを取ります。
IsManualAttach
データ型: Boolean
アクセスのタイプ: 読み取り/書き込み
TRUE の場合、この仮想ディスクは、Attach メソッドに対する明示的な呼び出しが行われた場合のみ、システムに接続されます。 このプロパティはストレージ スペースに固有であることに注意してください。
IsSnapshot
データ型: Boolean
アクセスの種類: 読み取り専用
この仮想ディスクが別の仮想ディスクのシャドウ コピーである場合は TRUE。
LogicalSectorSize
データ型: UInt64
アクセスの種類: 読み取り専用
修飾子: Units ("バイト")
仮想ディスクの論理セクター サイズ (バイト単位)。
名前
データ型: 文字列
アクセスの種類: 読み取り専用
修飾子: 必須
仮想ディスクを識別するために使用される半一意で (所有するストレージ サブシステムをスコープとする)、人間が判読できる文字列。
NameFormat
データ型: UInt16
アクセスの種類: 読み取り専用
修飾子: 必須
Name プロパティの形式。
Unknown (0)
Other (1)
VPD83NAA6 (2)
VPD83NAA5 (3)
VPD83Type2 (4)
VPD83Type1 (5)
VPD83Type0 (6)
SNVM (7)
NodeWWN (8)
NAA (9)
EUI64 (10)
T10VID (11)
NumberOfAvailableCopies
データ型: UInt16
アクセスの種類: 読み取り専用
使用可能なデータの一貫性のあるコピーの数。
NumberOfColumns
データ型: UInt16
アクセスの種類: 読み取り専用
この仮想ディスクのデータがストライピングされる基になる物理ディスクの数。
NumberOfDataCopies
データ型: UInt16
アクセスの種類: 読み取り専用
仮想ディスクに保持されている完全なデータ コピーの数。 たとえば、RAID 5 はデータの 1 つのコピーを維持しますが、RAID 1 は少なくとも 2 つのコピーを維持します。
OperationalStatus
データ型: UInt16 配列
アクセスの種類: 読み取り専用
仮想ディスクの現在の動作条件を示す値の配列。 HealthStatus とは異なり、このプロパティは、この仮想ディスクに関連するハードウェア、ソフトウェア、インフラストラクチャの問題の状態を示し、複数の値を含むことがあります。
| Value | 意味 |
|---|---|
| Unknown 0 | 動作状態が不明です。 |
| Other 1 | ベンダー固有の OperationalStatus は、 OtherOperationalStatusDescription プロパティを設定することによって指定されます。 |
| OK 2 | 仮想ディスクはコマンドに応答しており、通常の動作状態です。 |
| Degraded 3 | 仮想ディスクはコマンドに応答していますが、最適な動作状態で実行しているわけではありません。 |
| Stressed 4 | |
| 発生障害 5 | |
| Error 6 | |
| 回復できないエラー 7 | |
| 開始 8 | |
| Stopping 9 | |
| Stopped 10 | 仮想ディスクはコマンドに応答していますが、最適な動作状態で実行しているわけではありません。 |
| In Service 11 | 仮想ディスクは、構成、保守、クリーニング、または管理中です。 |
| 連絡先 12 | |
| Lost Communication 13 | |
| Aborted 14 | |
| Dormant 15 | |
| エラーのエンティティのサポート 16 | |
| Completed 17 | |
| Power モード 18 | |
| Relocating 19 | |
| Detached 0xD002 | この値は Windows 用に予約されています。 ホスト システムに表示されるが、ディスク デバイス オブジェクトがない仮想ディスク。 |
| Incomplete 0xD003 | 仮想ディスクに十分な冗長性が残っていないため、データを正常に修復または再生成できません。 |
OtherOperationalStatusDescription
データ型: String
アクセスの種類: 読み取り専用
OperationalStatus が Other を含んでいる場合、このプロパティは、ベンダーによって定義された動作状態を含む文字列です。 OperationalStatus が Other を含んでいない場合、このプロパティは NULL である必要があります。
OtherUsageDescription
データ型: String
アクセスの種類: 読み取り専用
仮想ディスクの Usage プロパティが Other に設定された場合、このプロパティは、ベンダーまたはユーザーによって定義された用途の説明を含む必要があります。 Usage が Other に設定されていない場合、このプロパティは NULL である必要があります。
ParityLayout
データ型: UInt16
アクセスの種類: 読み取り専用
パリティ ベースの回復性設定に使用されているパリティ レイアウトの種類。 仮想ディスクがパリティベースの回復性設定を使用しない場合、このプロパティは NULL でなければなりません。
Non-rotated Parity (1)
Rotated Parity (2)
PhysicalDiskRedundancy
データ型: UInt16
アクセスの種類: 読み取り専用
障害が発生してもデータの冗長性を損なわないバッキング物理ディスクの数。 たとえば、RAID 0 は障害を許容できず、RAID 5 は 1 つのドライブの障害を許容でき、RAID 6 は 2 つの障害を許容できます。
PhysicalSectorSize
データ型: UInt64
アクセスの種類: 読み取り専用
修飾子: Units ("バイト")
仮想ディスクの物理セクター サイズ (バイト単位)。
ProvisioningType
データ型: UInt16
アクセスの種類: 読み取り専用
修飾子: 必須
仮想ディスクのプロビジョニング スキーム。
| Value | 意味 |
|---|---|
| Unknown 0 | プロビジョニング スキームは不明です。 |
| Thin 1 | 仮想ディスクの容量は、オンデマンドで割り当てられます。 |
| 修正 2 | 仮想ディスクの容量は、作成時に完全に割り当てられます。 |
RequestNoSinglePointOfFailure
データ型: Boolean
アクセスの種類: 読み取り専用
単一障害点がないことを要求するには、TRUE に設定します。
ResiliencySettingName
データ型: String
アクセスの種類: 読み取り専用
修飾子: 必須、ModelCorrespondence {{"MSFT_ResiliencySetting.Name"}}
仮想ディスクの回復性設定の名前。
[サイズ]
データ型: UInt64
アクセスの種類: 読み取り専用
修飾子: Required, Units ("Bytes")
仮想ディスクの論理サイズ (バイト単位)。
UniqueIdFormat
データ型: UInt16
アクセスの種類: 読み取り専用
修飾子: 必須, Values ( "Vendor Specific", "Vendor Id", "EUI64", "FCPH Name", "SCSI Name String" ), ValueMap ("0", "1", "2", "3", "8"), ModelCorrespondence {{"MSFT_StorageObject.UniqueId"}}
このクラスが MSFT_StorageObject クラスから継承する UniqueId プロパティで使用される識別子の種類。 この識別子は、8 (最高)、3、2、1、0 (最低) の優先順位の中で、使用可能な最高の識別子である必要があります。
たとえば、仮想ディスク デバイスがタイプ 0、1、および 3 の識別子を公開している場合、UniqueId はタイプ 3 の識別子である必要があり、UniqueIdFormat は 3 に設定する必要があります。
UniqueIdFormatDescription
データ型: String
アクセスの種類: 読み取り専用
修飾子: ModelCorrespondence {{"MSFT_StorageObject.UniqueId"}}、 ModelCorrespondence {{"MSFT_VirtualDisk.UniqueIdFormat"}}
UniqueIdFormat の特定の値は、さまざまなサブ形式を含む場合があります。 このプロパティは、UniqueId で使用される特定の形式を記述するために使用される自由形式の文字列です。
使用方法
データ型: UInt16
アクセスのタイプ: 読み取り/書き込み
修飾子: 必須
この仮想ディスクの使用目的。
Unknown (0)
Other (1)
Unrestricted (2)
Reserved for ComputerSystem (the block server) (3)
Reserved by Replication Services (4)
Reserved by Migration Services (5)
Local Replica Source (6)
Remote Replica Source (7)
Local Replica Target (8)
Remote Replica Target (9)
Local Replica Source or Target (10)
Remote Replica Source or Target (11)
Delta Replica Target (12)
Element Component (13)
Reserved as Pool Contributor (14)
Composite Volume Member (15)
Composite VirtualDisk Member (16)
Reserved for Sparing (17)
WriteCacheSize
データ型: UInt64
アクセスの種類: 読み取り専用
仮想ディスクの書き込みキャッシュのサイズ。
解説
仮想ディスクは、物理ディスクと比較して拡張された属性セットを持つ使用可能なストレージのユニットです。 その他の属性の例としては、回復性と動的な容量拡張などがあります。
LUN とストレージ スペースは、仮想ディスクの例です。
Windows に公開されている仮想ディスクは、Windows スタックの残りの部分に (Windows) ディスクとして表示されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 名前空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |