MSFT_PhysicalDisk クラス

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

サブシステムドライブまたはスピンドルを表します。

次の構文は、マネージドオブジェクトフォーマット (MOF) コードをシンプルにしたものです。

構文

class MSFT_PhysicalDisk : MSFT_StorageFaultDomain
{
  UInt16  UniqueIdFormat;
  String  DeviceId;
  String  FriendlyName;
  UInt16  HealthStatus;
  UInt16  OperationalStatus[];
  String  OperationalDetails[];
  String  PhysicalLocation;
  UInt16  VirtualDiskFootprint;
  UInt16  Usage;
  UInt16  SupportedUsages[];
  String  Description;
  String  PartNumber;
  String  FirmwareVersion;
  String  SoftwareVersion;
  UInt64  Size;
  UInt64  AllocatedSize;
  UInt16  BusType;
  Boolean IsWriteCacheEnabled;
  Boolean IsPowerProtected;
  UInt64  PhysicalSectorSize;
  UInt64  LogicalSectorSize;
  UInt32  SpindleSpeed;
  Boolean IsIndicationEnabled;
  UInt16  EnclosureNumber;
  UInt16  SlotNumber;
  Boolean CanPool;
  UInt16  CannotPoolReason[];
  String  OtherCannotPoolReasonDescription;
  Boolean IsPartial;
  UInt16  MediaType;
};

メンバー

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

メソッド
[プロパティ]

メソッド

MSFT_PhysicalDisk クラスでは、次のメソッドを使用できます。

Method	説明
メンテナンス	ファームウェアの更新など、実体プール内の物理ディスクでメインテナント操作を実行できるようにします。
リセット	物理ディスクをリセットします。
SetAttributes	物理ディスクの属性を更新します。
SetDescription	物理ディスクの説明を設定または変更します。
SetFriendlyName	物理ディスクのフレンドリ名を設定または変更します。
SetUsage	実体プール内の物理ディスクの使用目的を設定または変更します。
SetWriteCache	物理ディスクの書き込みキャッシュを有効または無効にすることができます。

プロパティ

MSFT_PhysicalDisk クラスには、次のプロパティがあります。

AllocatedSize

データ型: UInt64

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

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

この物理ディスク上の使用済み領域の合計量。これには、すべてのストレージプールの使用状況と、ディスクに格納されているその他のデータが含まれている必要があります。

BusType

データ型: UInt16

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

修飾子: 必須

物理ディスクのストレージバスの種類。

Value	意味
不明 0	バスの種類が不明です。
SCSI 1	SCSI
ATAPI 2	ATAPI
ATA 3	ATA
1394 4	IEEE 1394
SSA 5	SSA
ファイバーチャネル 6	ファイバーチャネル
USB 7	USB
RAID 8	RAID
iSCSI 9	iSCSI
SAS 10	Serial Attached SCSI (SAS)
SATA 11	シリアル ATA (SATA)
SD 12	セキュアデジタル (SD)
MMC 13	マルチメディアカード (MMC)
MAX 14	この値は、システム使用のために予約されています。
File Backed Virtual 15	ファイルがバッキングされた仮想
ストレージスペース 16	記憶域スペース
NVMe 17
Microsoft 予約済み 18..	この値は、システム使用のために予約されています。

CannotPoolReason

データ型: UInt16 配列

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

修飾子: 必須

この物理ディスクを実体プールに追加できない理由を指定する値の配列。このプロパティは、CanPool プロパティが FALSE の場合にのみ有効です。

Unknown (0)

Other (1)

プール内 (2)

正常な状態ではありません (3)

リムーバブルメディア (4)

クラスターで使用中 (5)

オフライン (6)

容量の不足(7)

スペアディスク (8)

サブシステムで予約済み (9)

開始中 (10)

Microsoft 予約済み (..)

ベンダー予約済み (0x8000..)

CanPool

データ型: Boolean

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

修飾子: 必須

この物理ディスクを実体プールに追加できる場合は TRUE。

説明

データ型: 文字列

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

物理ディスクのユーザー設定可能な説明。

DeviceId

データ型: 文字列

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

物理ディスクに一意の名前を付けるアドレスまたはその他の識別子。

EnclosureNumber

データ型: UInt16

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

ディスクが物理的に存在するエンクロージャーの番号。

FirmwareVersion

データ型: 文字列

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

修飾子: 必須

ファームウェアリビジョンの文字列表現。

FriendlyName

データ型: 文字列

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

修飾子: 必須

物理ディスクのユーザーフレンドリな表示名。初期値はストレージプロバイダーまたはサブシステムによって設定する必要があり、オブジェクトの有効期間内の任意の時点でユーザーが変更できます。

HealthStatus

データ型: UInt16

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

デバイスの正常性の概要を示します。

Value	説明
0	Healthy
1	警告
2	異常
5	Unknown

IsIndicationEnabled

データ型: Boolean

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

物理ディスクの識別 LED がアクティブかどうかを示します。これは通常、メンテナンス操作で使用されます。

IsPartial

データ型: Boolean

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

この物理ディスクが通常のストレージプール操作以外のシステムまたはサービスによって部分的に使用される場合は TRUE。

IsPowerProtected

データ型: Boolean

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

この物理ディスクが、データを失うことなく電力損失を許容できるかどうかを示します。

IsWriteCacheEnabled

データ型: Boolean

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

この物理ディスクで書き込みキャッシュが有効かどうかを示します。

LogicalSectorSize

データ型: UInt64

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

修飾子: 必須, 単位 ("バイト")

物理ディスクの論理セクターサイズ (バイト単位)。たとえば、4K ネイティブディスクでは 4096 を報告し、512 バイトのエミュレートされたディスクは 512 を報告する必要があります。

MediaType

データ型: UInt16

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

物理ディスクのメディアの種類。

Value	説明
0	指定されていません。
3	HDD
4	SSD
5	SCM

OperationalDetails

データ型: 文字列 配列

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

特定の操作状態に関する詳細情報を提供する文字列の配列。

OperationalStatus

データ型: UInt16 配列

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

特定の正常性状態をさらに説明する操作状態の値の配列。

OtherCannotPoolReasonDescription

データ型: 文字列

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

ベンダーが定義した、この物理ディスクを実体プールに追加できない理由を含む文字列。 CannotPoolReason プロパティの値が Other でない場合、このプロパティは NULL である必要があります。

PartNumber

データ型: 文字列

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

修飾子: 必須

物理ディスクの部品番号または SKU の文字列表現。

PhysicalLocation

データ型: 文字列

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

このフィールドは、ハードウェアが配置されている場所を示す自由形式の文字列です。

PhysicalSectorSize

データ型: UInt64

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

修飾子: 必須, 単位 ("バイト")

物理ディスクの物理セクターサイズ (バイト単位)。たとえば、4K ネイティブディスクと 512 バイトのエミュレートディスクの場合、このプロパティの値は 4096 にする必要があります。

[サイズ]

データ型: UInt64

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

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

ディスクの物理ストレージサイズ (バイト単位)。

SlotNumber

データ型: UInt16

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

ディスクが物理的に存在するエンクロージャースロットの番号。

SoftwareVersion

データ型: 文字列

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

修飾子: 必須

ソフトウェアバージョン番号の文字列表現。

SpindleSpeed

データ型: UInt32

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

修飾子: 必須, 単位 ("RPM")

スピンドルベースの物理ディスクの回転数。ソリッドステートデバイス (SSD) またはその他の非回転メディアの場合、このメンバーは 0 に設定する必要があります。速度が不明な回転メディアの場合、このメンバーは 0xFFFFFFFF (UINT32_MAX) に設定する必要があります。

SupportedUsages

データ型: UInt16 配列

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

修飾子: 必須

この物理ディスクでサポートされている使用状況を指定する値の配列。

Value	意味
不明 0	使用目的が指定されていません。
自動選択 1	この物理ディスクは、データストレージにのみ使用する必要があります。
手動選択 2	この物理ディスクは、仮想ディスク作成時に管理者が手動で選択した場合にのみ使用する必要があります。手動選択ディスクは、PhysicalDisksToUse パラメーターを使用して CreateVirtualDisk に選択されます。
ホットスペア 3	この物理ディスクは、ホットスペアとして使用する必要があります。
廃止 4	この物理ディスクは使用を中止する必要があります。少なくとも、このディスクに新しい割り当てを行う必要はありません。このディスクに存在する仮想ディスクを修復する場合は、データを別のアクティブな物理ディスクに移動する必要があります。
ジャーナル 5	この物理ディスクは、仮想ディスクを構成する他のデバイスのキャッシュとして使用する必要があります。構成されている場合は、仮想ディスクのライトバックキャッシュが返されます。

UniqueIdFormat

データ型: UInt16

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

修飾子: 必須

UniqueId フィールドで使用される識別子の種類を示します (MSFT_StorageObjectから継承されます)。 UniqueId で使用される識別子は、8 (最高)、3、2、1、0 (最低) の優先順位の中で、使用可能な最高の識別子である必要があります。たとえば、物理ディスクデバイスが 0、1、3 の型の識別子を公開している場合、UniqueId は 3 の型の識別子である必要があり、UniqueIdFormat は 3 に設定する必要があります。

ベンダー固有 (0)

ベンダー ID (1)

EUI64 (2)

FCPH 名 (3)

SCSI 名文字列 (8)

使用方法

データ型: UInt16

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

修飾子: 必須

実体プール内でのこの物理ディスクの使用目的。

ストレージプールは、物理ディスクに割り当てられたポリシーに従う必要があります。

Value	意味
不明 0	使用目的が指定されていません。
自動選択 1	この物理ディスクは、データストレージにのみ使用する必要があります。
手動選択 2	この物理ディスクは、仮想ディスク作成時に管理者が手動で選択した場合にのみ使用する必要があります。手動選択ディスクは、PhysicalDisksToUse パラメーターを使用して CreateVirtualDisk に選択されます。
ホットスペア 3	この物理ディスクは、ホットスペアとして使用する必要があります。
廃止 4	この物理ディスクは使用を中止する必要があります。少なくとも、このディスクに新しい割り当てを行う必要はありません。このディスクに存在する仮想ディスクを修復する場合は、データを別のアクティブな物理ディスクに移動する必要があります。
ジャーナル 5	この物理ディスクは、仮想ディスクを構成する他のデバイスのキャッシュとして使用する必要があります。構成されている場合は、仮想ディスクのライトバックキャッシュが返されます。

VirtualDiskFootprint

データ型: UInt16

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

このフィールドは、この物理ディスク上の仮想ディスクからのユーザーデータフットプリントのサイズをバイト単位で示します。

要件

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

次の方法で共有

MSFT_PhysicalDisk クラス

構文

メンバー

メソッド

プロパティ

要件

フィードバック

その他のリソース