次の方法で共有

Msvm_GuestServiceInterfaceComponentSettingData クラス

  • [アーティクル]

ゲスト サービス インターフェイス コンポーネントの構成済みの状態を表します。 このクラスは、CIM_ResourceAllocationSettingData クラスから派生します。

次の構文は MOF コードから簡略化されたもので、継承されたすべてのプロパティが含まれています。

構文

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_GuestServiceInterfaceComponentSettingData : CIM_ResourceAllocationSettingData
{
  string  ElementName;
  string  InstanceID;
  uint16  ResourceType;
  string  OtherResourceType;
  string  ResourceSubType;
  string  PoolID;
  uint16  ConsumerVisibility;
  string  HostResource[];
  string  AllocationUnits;
  uint64  VirtualQuantity;
  uint64  Reservation;
  uint64  Limit;
  uint32  Weight;
  boolean AutomaticAllocation;
  boolean AutomaticDeallocation;
  string  Parent;
  string  Connection[];
  string  Address;
  uint16  MappingBehavior;
  uint16  EnabledState = 3;
  uint16  DefaultEnabledStatePolicy = 2;
};

メンバー

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

Properties

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

住所

データ型: string

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

リソースのアドレス。 たとえば、イーサネット ポートの MAC アドレスです。

AllocationUnits

データ型: string

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

このプロパティは、Reservation プロパティと Limit プロパティで使用される割り当ての単位を指定します。 たとえば、ResourceType=Processor の場合、AllocationUnits を MHz に設定できます。 ResourceType=Memory の場合、AllocationUnits を MB に設定できます

AutomaticAllocation

データ型: boolean

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

このプロパティは、リソースを自動的に割り当てるかどうかを指定します。 たとえば、true に設定すると、使用している仮想コンピューター システムの電源がオンになると、このリソースが割り当てられます。 false の値は、リソースを明示的に割り当てる必要があることを示します。 たとえば、この設定は電源オン時には存在しないメディア、つまり cdrom やフロッピーなどのリムーバブル メディアを表します。 リソースを割り当てるには、明示的な操作が必要です。

AutomaticDeallocation

データ型: boolean

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

このプロパティは、リソースの割り当てを自動的に解除するかどうかを指定します。 たとえば、true に設定すると、使用している仮想コンピューター システムの電源がオフになると、このリソースの割り当てが解除されます。 false に設定すると、リソースは割り当てられたままになり、明示的に割り当てを解除する必要があります。

接続

データ型: string 配列

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

このリソースが接続されている対象です。 たとえば、名前付きネットワークまたはスイッチ ポートなどです。

ConsumerVisibility

データ型: uint16

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

割り当てられたリソースに対するコンシューマーの可視性について説明します。

Value 意味
不明
0
 不明。
Passed-Through
2
 基になるリソースまたはホスト リソースが利用され、おそらくパーティション分割を使用してコンシューマーに渡されます。 DeviceID プロパティには、少なくとも 1 つの項目が存在する必要があります。
Virtualized
3
 リソースは仮想化されており、基になる/ホスト リソースに直接マップされない場合があります。 一部の実装では、仮想化されたリソースに対する特定の割り当てがサポートされている場合があります。その場合、ホスト リソースは DeviceID プロパティを使用して公開されます。
Not represented
4
 リソース表現が、リソース コンシューマーのコンテキスト内に存在しません。
DMTF reserved
..
Vendor Reserved
32767..65535

DefaultEnabledStatePolicy

データ型: uint16

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

ゲスト通信サービスの有効または無効の規程の状態です。

これは読み取り専用プロパティですが、Msvm_VirtualSystemManagementService クラスの ModifyResourceSettings メソッドを使用することで変更できます。

Note

Windows 10 で追加されました。

有効 (2)

無効 (3)

ElementName

データ型: string

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

SettingData のこのインスタンスの表示名です。 さらに、表示名は、検索またはクエリのインデックス プロパティとして使用できます。 (注: 名前は名前空間内で一意である必要はありません)。

EnabledState

データ型: uint16

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

要素の有効または無効の状態です。

これは読み取り専用プロパティですが、Msvm_VirtualSystemManagementService クラスの ModifyVirtualSystemResources メソッド (または Windows 10 以降では ModifyResourceSettings) を使用して変更できます。

有効な値は次のとおりです。

有効 (2)

無効 (3)

HostResource

データ型: string 配列

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

このプロパティは、ホストまたは基になるリソースに特定の割り当てを公開します。 埋め込みインスタンスにはキー プロパティのみが含まれており、オブジェクト パスとして扱われます。 仮想リソースが多数の基になるリソースに対してスケジュールされる可能性がある場合、このプロパティは NULL のままである必要があります。 その場合、DeviceAllocatedFromPool または ResourceAllocationFromPool の関連付けを使用して、この仮想リソースをスケジュールできるホスト リソースのプールを決定できます。 特定の割り当てを使用する場合、この仮想リソースによって使用されるすべての基になるリソースがこの配列に一覧表示されます。 通常、配列には 1 つの項目が含まれますが、複数のプロセッサなどの集計割り当ての場合は、複数のホスト リソースを指定できます。

InstanceID

データ型: string

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

修飾子: キー

インスタンス化する名前空間のスコープ内で、InstanceID は、このクラスのインスタンスを不透明かつ一意に識別します。 名前空間内で一意性を確保するには、InstanceID の値を次の "優先" アルゴリズムを使用して構築する必要があります: OrgID:LocalID。ここで、OrgID と LocalID はコロン (:) で区切られ、OrgID には、InstanceID を作成または定義しているビジネス エンティティが所有する著作権で保護された、商標登録されている、またはその他の一意の名前、もしくは、広く認知されている国際機関によってビジネス エンティティに割り当てられている登録 ID を含む必要があります。 (この要件はスキーマ クラス名の SchemaName_ClassName 構造体と似ています。)さらに、一意性を確保するために、 OrgID にコロン (:)を含めてはなりません。 このアルゴリズムを使用する場合は、InstanceID に表示される最初のコロンが OrgID と LocalID の間に表示される必要があります。 LocalID はビジネス エンティティによって選択され、異なる基になる (実際の) 要素を識別するために再利用しないでください。 上記の "優先" アルゴリズムを使用しない場合、定義するエンティティは、定義した InstanceID が、このインスタンスの NameSpace に対して、このプロバイダーまたは他のプロバイダーによって生成される InstanceID で再利用されないようにする必要があります。 DMTF で定義されたインスタンスの場合、OrgID を CIM に設定して "優先" アルゴリズムを使用する必要があります。

限度

データ型: uint64

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

このプロパティは、この割り当てに付与されるリソースの上限または最大量を指定します。 たとえば、メモリ ページングをサポートするシステムでは、メモリ割り当ての制限値を VirtualQuantity より少なく設定することがサポートされていて、この割り当てに対して強制的なページングが実行できる場合があります。

MappingBehavior

データ型: uint16

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

このリソースを基になるリソースにマップする方法を指定します。 HostResource 配列にエントリが含まれている場合、このプロパティはリソースがそれらの特定のリソースにどのようにマップされるかを反映します。

不明 (0)

サポート非対称 (1)

専用 (2)

ソフト アフィニティ (3)

ハード アフィニティ (4)

DMTF 予約済み (..)

ベンダー予約済み (32767..65535)

OtherResourceType

データ型: string

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

適切に定義された値が使用できず、ResourceType の値が "Other" である場合に、リソースの種類を表す文字列です。

Parent

データ型: string

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

リソースの親です。 たとえば、現在の割り当てのコントローラーです。

PoolID

データ型: string

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

このプロパティは、リソースが現在割り当てられている ResourcePool、または割り当てが発生したときにリソースが割り当てられる ResourcePool を指定します。

予約

データ型: uint64

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

このプロパティは、この割り当てで使用できるリソースの量を指定します。 リソースの過剰コミットメントをサポートするシステムでは、通常、この値は、割り当てが受け入れられるのを防ぎ、リソースの枯渇を防ぐために、アドミッション制御に使用されます。

ResourceSubType

データ型: string

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

このリソースの実装固有のサブタイプを記述する文字列です。 たとえば、これは、同じリソースの種類の異なるモデルを区別するために使用できます。

ResourceType

データ型: uint16

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

この割り当て設定が表すリソースの種類です。

その他 (1)

コンピューター システム (2)

プロセッサ (3)

メモリ (4)

IDE コントローラー (5)

Parallel SCSI HBA (6)

FC HBA (7)

iSCSI HBA (8)

IB HCA (9)

イーサネット アダプター (10)

その他のネットワーク アダプター (11)

I/O スロット (12)

I/O デバイス (13)

フロッピー ドライブ (14)

CD ドライブ (15)

DVD ドライブ (16)

シリアル ポート (17)

並列ポート (18)

USB コントローラー (19)

グラフィックス コントローラー (20)

ストレージエクステント (21)

ディスク (22)

テープ (23)

その他のストレージ デバイス (24)

Firewire コントローラー (25)

パーティション分割可能ユニット (26)

基本パーティション分割可能ユニット (27)

電源 (28)

冷却装置 (29)

DMTF 予約済み (...)

ベンダー予約済み (32767..65535)

VirtualQuantity

データ型: uint64

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

このプロパティは、コンシューマーに提示されるリソースの量を指定します。 たとえば、ResourceType=Processor の場合、このプロパティは仮想コンピューター システムに表示される個別のプロセッサの数を反映します。 ResourceType=Memory の場合、このプロパティは仮想コンピューター システムに報告された MB の数を反映する場合があります。

Weight

データ型: uint32

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

このプロパティは、同じ ResourcePool からの他の割り当てに関連して、この割り当ての相対的な優先順位を指定します。 このプロパティには測定単位がなく、同じホスト リソースに対して競合する他の割り当てと比較した場合にのみ関連します。

必要条件

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

関連項目

CIM_ResourceAllocationSettingData

CIM_ResourceAllocationSettingData