次の方法で共有


Msvm_VirtualHardDiskSettingData クラス

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

次の構文は、簡略化されたマネージ オブジェクト形式 (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 クラスには、次の種類のメンバーがあります。

プロパティ

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