Msvm_VirtualHardDiskSettingData クラス

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

仮想ハードディスクの設定データを提供します。

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

構文

[AMENDMENT]
class Msvm_VirtualHardDiskSettingData : CIM_SettingData
{
  string   InstanceID;
  string   Caption = "Virtual Hard Disk Setting Data";
  string   Description = "Setting Data for a Virtual Hard Disk";
  string   ElementName;
  uint16   Type;
  uint16   Format;
  string   Path;
  string   ParentPath;
  DATETIME ParentTimestamp;
  string   ParentIdentifier;
  uint64   MaxInternalSize;
  uint32   BlockSize;
  uint32   LogicalSectorSize;
  uint32   PhysicalSectorSize;
  string   VirtualDiskId;
  uint64   DataAlignment;
  uint16   PmemAddressAbstractionType;
  boolean  IsPmemCompatible;
};

メンバー

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

Properties

プロパティ

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

BlockSize

データ型: uint32
アクセスの種類: 読み取り/書き込み

仮想ハードディスクで使用されるブロックサイズ (バイト単位)。

Caption

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

オブジェクトの簡単な説明。このプロパティは CIM_ManagedElementから継承され、常に "仮想ハードディスク設定データ" に設定されます。

DataAlignment

データ型: uint64
アクセスの種類: 読み取り/書き込み

仮想ディスクのデータペイロードに必要な配置をバイト単位で指定します。

注意

Windows 10 バージョン 1709 に追加されました。

説明

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

オブジェクトの説明。このプロパティは CIM_ManagedElementから継承され、常に "仮想ハードディスクのデータの設定" に設定されます。

ElementName

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

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

Format

データ型: uint16
アクセスの種類: 読み取り/書き込み

仮想ハードディスクの形式。これは、次のいずれかの値になります。

VHD (2)

VHDX (3)

VHDSet (4)

注意

Windows 10 と Windows Server 2016 に追加されました。

InstanceID

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

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

IsPmemCompatible

データ型: boolean
アクセスの種類: 読み取り/書き込み

永続メモリデバイスのバッキングストアとして仮想ディスクを使用できるかどうかを指定します。

注意

Windows 10 バージョン 1709 に追加されました。

LogicalSectorSize

データ型: uint32
アクセスの種類: 読み取り/書き込み

仮想ハードディスクで使用される論理セクターサイズ (バイト単位)。

MaxInternalSize

データ型: uint64
アクセスの種類: 読み取り/書き込み

仮想マシンが表示できる仮想ハードディスクの最大サイズ (バイト単位)。このサイズは、セクターサイズの次に大きい倍数に切り上げられます。

ParentIdentifier

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

仮想ハードディスクの親を一意に識別するために使用される GUID。仮想ハードディスクに親がない場合、このフィールドは空です。

注意

Windows 10 と Windows Server 2016 に追加されました。

ParentPath

データ型: string
アクセスの種類: 読み取り/書き込み

仮想ハードディスクの親。仮想ハードディスクに親がない場合、このプロパティは空です。

ParentTimestamp

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

仮想ハードディスクの親のタイムスタンプ。仮想ハードディスクに親がない場合、このフィールドは空です。

注意

Windows 10 と Windows Server 2016 に追加されました。

パス

データ型: string
アクセスの種類: 読み取り/書き込み

仮想ハードディスクの完全修飾パス。

PhysicalSectorSize

データ型: uint32
アクセスの種類: 読み取り/書き込み

仮想ハードディスクで使用される物理セクターサイズ (バイト単位)。

PmemAddressAbstractionType

データ型: uint16
アクセスの種類: 読み取り/書き込み

この仮想ディスクで使用する永続メモリアドレス抽象化メソッド。

注意

Windows 10 バージョン 1709 に追加されました。

なし (0)

BTT (1)

不明 (65535)

Type

データ型: uint16
アクセスの種類: 読み取り/書き込み

仮想ハードディスクの種類。これは、次のいずれかの値になります。

修正済み (2)

動的 (3)

差分 (4)

VirtualDiskId

データ型: string
アクセスの種類: 読み取り/書き込み

仮想ディスクを一意に識別するために使用される GUID。

Msvm_ImageManagementService.GetVirtualHardDiskSettingData メソッドが Msvm_VirtualHardDiskSettingData のインスタンスを返す場合、クライアントはこのプロパティを使用して VHD の一意のディスク ID を取得できます。

競合検出時またはその他の場合、クライアントは VirtualDiskId 値を新しい GUID に設定し、この Msvm_VirtualHardDiskSettingData インスタンスを Msvm_ImageManagementService.SetVirtualHardDiskSettingData メソッドに渡して VHD のディスク ID を変更できます。 VHD が VHDX VHD ではない場合、または VHD がアタッチされている場合、操作は失敗します。渡された値の形式が正しくない場合、つまり GUID ではない場合、またはすべての 0 が含まれている場合も、操作は失敗します。渡された値が現在のディスク ID と同じ場合、操作は自動的に成功します。

SetVirtualDiskInformation 関数によって生成されたエラーは、このプロパティによってバブルアップされます。クライアントは、同じメカニズムを使用して、同じ名前空間の Msvm_ImageManagementService.CreateVirtualHardDisk メソッドを使用して VHD 作成時に VirtualDiskId 値を提供することもできます。これは、VHD1 または VHD2 VHD を作成するために使用できます。

Windows 8.1: この値は、Windows 8.1して R2 をWindows Server 2012するまでサポートされません。

要件

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

こちらもご覧ください

CIM_SettingData
GetVirtualHardDiskSettingData

次の方法で共有

Msvm_VirtualHardDiskSettingData クラス

構文

メンバー

プロパティ

要件

こちらもご覧ください

フィードバック

その他のリソース