Msvm_DiskDrive クラス

[アーティクル]
06/13/2023

仮想マシン内のハードディスクドライブを表します。このハードディスクドライブは、パススルーデバイス (物理ハードディスクが仮想マシンに接続されている場合) または仮想ハードディスクメディアが設定された合成デバイスのいずれかです。仮想ハードディスクと物理ハードディスクは仮想マシンに追加および削除できるため、このクラスには 2 つのリソースプールが関連付けられています。1 つはパススルーハードディスク用、もう 1 つは仮想ハードディスク用です。ハードディスクは、仮想マシンがオンラインの場合にのみ、仮想 SCSI コントローラーに追加または削除できます。ディスクは、仮想マシンがオフラインの場合にのみ、仮想 IDE コントローラーに追加または削除できます。

次の構文は、簡略化されたマネージドオブジェクト形式 (MOF) コードであり、継承されたすべてのプロパティが含まれています。

構文

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_DiskDrive : CIM_DiskDrive
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   CreationClassName;
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  string   ErrorMethodology = "None";
  string   CompressionMethod = "Not Compressed";
  uint32   NumberOfMediaSupported = 1;
  uint64   MaxMediaSize = 2000000000;
  uint64   DefaultBlockSize = 512;
  uint64   MaxBlockSize;
  uint64   MinBlockSize = 512;
  boolean  NeedsCleaning = False;
  boolean  MediaIsLocked = True;
  uint16   Security = 3;
  datetime LastCleaned;
  uint64   MaxAccessTime = 0;
  uint32   UncompressedDataRate;
  uint64   LoadTime = 0;
  uint64   UnloadTime = 0;
  uint64   MountCount = 0;
  datetime TimeOfLastMount;
  uint64   TotalMountTime = 0;
  string   UnitsDescription;
  uint64   MaxUnitsBeforeCleaning = 0xffffffffffffffff;
  uint64   UnitsUsed = 0;
  uint32   DriveNumber;
};

メンバー

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

メソッド
プロパティ

メソッド

Msvm_DiskDrive クラスには、これらのメソッドがあります。

メソッド	説明
EnableDevice	このメソッドはサポートされていません。
LockMedia	メディアをロックまたは解放します。
OnlineDevice	このメソッドはサポートされていません。
QuiesceDevice	このメソッドはサポートされていません。
RequestStateChange	状態の変更を要求します。
リセット	仮想デバイスをリセットします。
RestoreProperties	このメソッドはサポートされていません。
SaveProperties	このメソッドはサポートされていません。
SetPowerState	このメソッドはサポートされていません。

プロパティ

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

AdditionalAvailability

データ型: uint16 配列
アクセスの種類: 読み取り専用

このプロパティは CIM_LogicalDeviceから継承され、6 (該当なし) に設定されます。

可用性

データ型: uint16
アクセスの種類: 読み取り専用

このプロパティは、 CIM_LogicalDeviceから継承されます。

AvailableRequestedStates

データ型: uint16 配列
アクセスの種類: 読み取り専用

RequestStateChange メソッドの RequestedState パラメーターに指定できる値を示します。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

Capabilities

データ型: uint16 配列
アクセスの種類: 読み取り専用

メディアアクセスデバイスの機能。このプロパティは CIM_MediaAccessDeviceから継承され、次の値に設定されます。

値	説明
3	CapabilityDescriptions の対応するエントリは、"ランダムアクセス" です。
4	CapabilityDescriptions の対応するエントリは、"書き込みをサポートしています" です。

CapabilityDescriptions

データ型: 文字列 配列
アクセスの種類: 読み取り専用

Capabilities プロパティ配列に示されているアクセスデバイス機能の詳細な説明を提供する自由形式の文字列の配列。この配列の各エントリは、同じインデックスにある Capabilities プロパティ配列のエントリに関連しています。このプロパティは、 CIM_MediaAccessDeviceから継承されます。

Caption

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの簡単な説明。このプロパティは、 CIM_ManagedElementから継承されます。

CommunicationStatus

データ型: uint16
アクセスの種類: 読み取り専用

基になるマネージド要素と通信するインストルメンテーションの機能を示します。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは、 CIM_ManagedSystemElementから継承されます。

不明 (0)
使用できません (1)
通信 OK (2)
失われた通信 (3)
連絡先なし (4)
DMTF 予約済み (...)
Vendor Reserved (0x8000.. )

CompressionMethod

データ型: string
アクセスの種類: 読み取り専用

論理ファイルの圧縮に使用されるアルゴリズムまたはツールを示す文字列。圧縮スキームが不明であるか、説明されていない場合は、"不明" を使用します。論理ファイルが圧縮されていても、圧縮スキームが不明であるか、説明されていない場合は、"圧縮" を使用します。論理ファイルが圧縮されていない場合は、"圧縮されていない" を使用します。このプロパティは CIM_MediaAccessDeviceから継承され、"Not Compressed" に設定されます。

CreationClassName

データ型: uint16
アクセスの種類: 読み取り専用

インスタンスの作成で使用されるクラスまたはサブクラスの名前。このプロパティは、 CIM_LogicalDeviceから継承されます。

DefaultBlockSize

データ型: uint64
アクセスの種類: 読み取り専用

デバイスの既定のブロックサイズ (バイト単位)。このプロパティは CIM_MediaAccessDeviceから継承され、512 に設定されます。

説明

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの説明。このプロパティは、 CIM_ManagedElementから継承されます。

DetailedStatus

データ型: uint16
アクセスの種類: 読み取り専用

PrimaryStatus プロパティに追加の状態の詳細を補完します。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは、 CIM_ManagedSystemElementから継承されます。

使用できません (0)
追加情報なし (1)
ストレス ( 2)
予測エラー (3)
回復できないエラー (4)
エラーのサポートエンティティ (5)
DMTF 予約済み (...)
Vendor Reserved (0x8000.. )

DeviceID

データ型: string
アクセスの種類: 読み取り専用

論理デバイスに一意の名前を付けるアドレスまたはその他の識別情報。このプロパティは、 CIM_LogicalDeviceから継承されます。

DriveNumber

データ型: uint32
アクセスの種類: 読み取り専用

ホスティングコンピューターシステム上の物理ドライブの数。

ElementName

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの表示名。このプロパティは、 CIM_ManagedElementから継承されます。

EnabledDefault

データ型: uint16
アクセスの種類: 読み取り専用

要素の有効な状態に対する管理者の既定の構成またはスタートアップ構成。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

EnabledState

データ型: uint16
アクセスの種類: 読み取り専用

要素の有効および無効の状態。また、これらの要求された状態間の遷移を示すこともできます。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

値	説明
Unknown 0	要素の状態を特定できませんでした。
その他 1
有効 2	要素が実行中です。
Disabled 3	要素はオフになっています。
シャットダウン 4	要素は Disabled 状態になる処理中です。
該当なし 5	要素は、有効または無効をサポートしていません。
有効だがオフライン 6	要素はコマンドを完了している可能性があり、新しい要求はすべて削除されます。
テスト中 7	要素はテスト状態です。
遅延 8	要素はコマンドを完了している可能性がありますが、新しい要求はキューに入れられます。
休止 9	要素は有効になっていますが、制限モードです。要素の動作は Enabled 状態 (2) に似ていますが、制限された一連のコマンドのみを処理します。その他のすべての要求はキューに入れられます。
開始中 10	要素は、Enabled 状態 (2) に移動中です。新しい要求がキューに入れられます。

ErrorCleared

データ型: ブール値
アクセスの種類: 読み取り専用

このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

ErrorDescription

データ型: string
アクセスの種類: 読み取り専用

このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

ErrorMethodology

データ型: string
アクセスの種類: 読み取り専用

このデバイスでサポートされているエラー検出と修正の種類を表す文字列。このプロパティは CIM_MediaAccessDeviceから継承され、"None" に設定されます。

HealthState

データ型: uint16
アクセスの種類: 読み取り専用

要素の現在の正常性。この属性は、この要素の正常性を表しますが、必ずしもサブコンポーネントの正常性を表すわけではありません。指定できる値は 0 ~ 30 で、5 は要素が完全に正常であることを意味し、30 は要素が完全に非機能であることを意味します。このプロパティは CIM_ManagedSystemElementから継承され、常に 5 に設定されます。

IdentifyingDescriptions

データ型: 文字列 配列
アクセスの種類: 読み取り専用

このプロパティは CIM_LogicalDeviceから継承され、Null に設定 されます。

InstallDate

データ型: datetime
アクセスの種類: 読み取り専用

仮想マシン構成が作成された日時。このプロパティは、 CIM_ManagedSystemElementから継承されます。

InstanceID

データ型: string
アクセスの種類: 読み取り専用
修飾子: キー

このクラスのインスタンスを一意に識別します。このプロパティは、 CIM_ManagedElementから継承されます。

LastCleaned

データ型: datetime
アクセスの種類: 読み取り専用

デバイスが最後にクリーンアップされた日時。このプロパティは CIM_MediaAccessDeviceから継承され、Null に設定 されます。

LastErrorCode

データ型: uint32
アクセスの種類: 読み取り専用

このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

LoadTime

データ型: uint64
アクセスの種類: 読み取り専用

読み込みからメディアの読み取りまたは書き込みまでの時間 (ミリ秒単位)。たとえば、ディスクドライブの場合、これはディスクが読み取り/書き込みの準備ができていることを報告するディスクに回転しない間隔です (つまり、ディスクが通常の速度で回転します)。テープドライブの場合、メディアが挿入されてから、アプリケーションの準備ができていることを報告する時間です。これは通常、テープの BOT 領域にあります。このプロパティは CIM_MediaAccessDevice から継承され、0 に設定されます。

MaxAccessTime

データ型: uint64
アクセスの種類: 読み取り専用

メディア上の最初の場所から時間に関して最も遠い場所に移動する時間 (ミリ秒単位)。ディスクドライブの場合、これはフルシークと完全回転遅延を表します。テープドライブの場合、これはテープの先頭から最も物理的に離れた場所までの検索を表します。 (テープの終端は物理的に最も離れた場所にある可能性がありますが、これは必ずしも当てはまるとは限りません)。このプロパティは CIM_MediaAccessDeviceから継承され、0 に設定されます。

MaxBlockSize

データ型: uint64
アクセスの種類: 読み取り専用

デバイスがアクセスするメディアの最大ブロックサイズ (バイト単位)。このプロパティは CIM_MediaAccessDeviceから継承され、仮想ハードディスクドライブの場合は 512 に設定され、パススルードライブの場合は変数に設定されます。

MaxMediaSize

データ型: uint64
アクセスの種類: 読み取り専用

このデバイスでサポートされているメディアの最大サイズ (キロバイト単位)。キロバイトは、バイト数に 1000 を掛けたバイト数として解釈されます (1024 を掛けたバイト数ではありません)。このプロパティは CIM_MediaAccessDeviceから継承され、仮想ハードディスクドライブの場合は 2,000,000,000 に設定され、パススルードライブの場合は可変です。

MaxQuiesceTime

データ型: uint64
アクセスの種類: 読み取り専用

このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

MaxUnitsBeforeCleaning

データ型: uint64
アクセスの種類: 読み取り専用

デバイスをクリーニングする前に使用できる最大ユニット。このプロパティは CIM_MediaAccessDeviceから継承され、0xffffffffffffffffに設定されます。

MediaIsLocked

データ型: ブール値
アクセスの種類: 読み取り専用

True を指定 すると、メディアはデバイスでロックされ、取り出すことができません。それ以外の場合は False。このプロパティは CIM_MediaAccessDeviceから継承され、True に設定 されます。

MinBlockSize

データ型: uint64
アクセスの種類: 読み取り専用

デバイスがアクセスするメディアの最小ブロックサイズ (バイト単位)。このプロパティは CIM_MediaAccessDeviceから継承され、512 に設定されます。

MountCount

データ型: uint64
アクセスの種類: 読み取り専用

リムーバブルメディアをサポートするデバイスの場合、データ転送またはデバイスのクリーンにメディアがマウントされた回数。ハードディスクなどの移動不可能なメディアにアクセスするデバイスの場合、このプロパティは適用されず、0 に設定する必要があります。このプロパティは CIM_MediaAccessDeviceから継承され、0 に設定されます。

名前

データ型: string
アクセスの種類: 読み取り専用

オブジェクトが認識されるラベル。このプロパティは、 CIM_ManagedSystemElementから継承されます。

NeedsCleaning

データ型: ブール値
アクセスの種類: 読み取り専用

メディアアクセスデバイスでクリーニングが必要な場合は True。それ以外の場合は False。このプロパティは CIM_MediaAccessDeviceから継承され、False に設定 されます。

NumberOfMediaSupported

データ型: uint32
アクセスの種類: 読み取り専用

サポートまたは挿入できる複数の個々のメディアの最大数。このプロパティは CIM_MediaAccessDeviceから継承され、1 に設定されます。

OperatingStatus

データ型: uint16
アクセスの種類: 読み取り専用

要素の操作条件の現在の状態情報を提供し、 EnabledState プロパティの値に関する詳細を提供するために使用できます。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは 、CIM_ManagedSystemElementから継承されます。

不明 (0)
使用できません (1)
サービス (2)
開始 (3)
停止中 (4)
停止 ( 5)
中止 ( 6)
休止状態 (7)
完了 (8)
移行 ( 9)
Emigrating (10)
未移行 (11)
スナップショット処理 (12)
シャットダウン (13)
In Test (14)
移行中 (15)
In Service (16)
DMTF 予約済み (..)
ベンダー予約 済み (0x8000.. )

OperationalStatus

データ型: uint16 配列
アクセスの種類: 読み取り専用

オブジェクトの現在の状態。このプロパティは 、CIM_ManagedSystemElementから継承されます。

OtherEnabledState

データ型: string
アクセスの種類: 読み取り専用

EnabledState プロパティが 1 (Other) に設定されている場合の要素の有効または無効の状態。 EnabledState が 1 以外の値である場合、このプロパティは Null に設定する必要があります。このプロパティは CIM_EnabledLogicalElementから継承され、常に Null に設定 されます。

OtherIdentifyingInfo

データ型: 文字列 配列
アクセスの種類: 読み取り専用

このプロパティは CIM_LogicalDeviceから継承され、Null に設定 されます。

PowerManagementCapabilities

データ型: uint16 配列
アクセスの種類: 読み取り専用

このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

PowerManagementSupported

データ型: boolean
アクセスの種類: 読み取り専用

このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

PowerOnHours

データ型: uint64
アクセスの種類: 読み取り専用

このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

PrimaryStatus

データ型: uint16
アクセスの種類: 読み取り専用

高レベルの状態情報を提供します。このプロパティは、要素とそのサブコンポーネントの高レベルで詳細な正常性状態を提供するために 、DetailedStatus プロパティと組み合わせて使用する必要があります。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは 、CIM_ManagedSystemElementから継承されます。

不明 (0)
OK (1)
機能低下 (2)
エラー (3)
DMTF 予約済み (..)
ベンダー予約 済み (0x8000.. )

RequestedState

データ型: uint16
アクセスの種類: 読み取り専用

要素に対して最後に要求された状態または目的の状態。要素の実際の状態は EnabledState で表されます。このプロパティは、最後に要求された状態と現在有効または無効になっている状態を比較するために提供されます。 CIM_EnabledLogicalElementの特定のインスタンスが RequestStateChange メソッドをサポートしていない場合があります。これが発生した場合は、値 12 (該当なし) が使用されます。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

Security

データ型: uint16
アクセスの種類: 読み取り専用

デバイスに対して定義された運用セキュリティ。このプロパティは CIM_MediaAccessDeviceから継承され、3 (なし) に設定されます。

状態

データ型: string
アクセスの種類: 読み取り専用

このプロパティは CIM_ManagedSystemElementから継承されますが、使用されません。

StatusDescriptions

データ型: 文字列 配列
アクセスの種類: 読み取り専用

さまざまな OperationalStatus 配列値を記述する文字列。このプロパティは 、CIM_ManagedSystemElementから継承されます。

StatusInfo

データ型: uint16
アクセスの種類: 読み取り専用

このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

SystemCreationClassName

データ型: string
アクセスの種類: 読み取り専用

スコープシステムの作成クラス名。このプロパティは 、CIM_LogicalDeviceから継承されます。

Systemname

データ型: string
アクセスの種類: 読み取り専用

スコープ仮想マシンの一意識別子。このプロパティは 、CIM_LogicalDeviceから継承されます。

TimeOfLastMount

データ型: datetime
アクセスの種類: 読み取り専用

リムーバブルメディアをサポートするデバイスの場合、メディアがデバイスにマウントされた最新の日付と時刻。ハードディスクなどの移動不可能なメディアにアクセスするデバイスの場合、このプロパティは意味がなく、適用できません。このプロパティは CIM_MediaAccessDeviceから継承され、Null に設定 されます。

TimeOfLastStateChange

データ型: datetime
アクセスの種類: 読み取り専用

要素の有効な状態が最後に変更された日時。このプロパティは CIM_EnabledLogicalElementから継承され、常に "NULL" に設定されます。

TotalMountTime

データ型: uint64
アクセスの種類: 読み取り専用

リムーバブルメディアをサポートするデバイスの場合、データ転送またはデバイスのクリーンにメディアがマウントされた合計時間 (秒単位)。ハードディスクなどの移動不可能なメディアにアクセスするデバイスの場合、このプロパティは適用されず、0 に設定する必要があります。このプロパティは CIM_MediaAccessDeviceから継承され、0 に設定されます。

TotalPowerOnHours

データ型: uint64
アクセスの種類: 読み取り専用

このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

TransitioningToState

データ型: uint16
アクセスの種類: 読み取り専用

インスタンスが遷移しているターゲットの状態を示します。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

CompressedDataRate

データ型: uint32
アクセスの種類: 読み取り専用

デバイスがメディアから読み取り、メディアに書き込むことができる持続的なデータ転送速度 (KB/秒)。これは、持続的な生データレートです。圧縮を想定した最大レートまたはレートは、このプロパティで報告しないでください。このプロパティは CIM_MediaAccessDeviceから継承され、Null に設定 されます。

UnitsDescription

データ型: string
アクセスの種類: 読み取り専用

MaxUnitsBeforeCleaning での使用に対する相対的な単位。このプロパティは CIM_MediaAccessDeviceから継承され、Null に設定 されます。

UnitsUsed

データ型: uint64
アクセスの種類: 読み取り専用

現在使用されている単位数。このプロパティは CIM_MediaAccessDeviceから継承され、0 に設定されます。

UnloadTime

データ型: uint64
アクセスの種類: 読み取り専用

メディアの読み取りまたは書き込みが可能からアンロードまでの時間 (ミリ秒単位)。このプロパティは CIM_MediaAccessDeviceから継承され、0 に設定されます。

注釈

MSVM_DISKDRIVE クラスへのアクセスは、UAC フィルター処理によって制限される場合があります。詳細については、「ユーザーアカウント制御と WMI」を参照してください。

要件

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

こちらもご覧ください

CIM_DiskDrive
CIM_DiskDrive
ストレージクラス

次の方法で共有

Msvm_DiskDrive クラス

構文

メンバー

メソッド

プロパティ

注釈

要件

こちらもご覧ください

フィードバック

その他のリソース