Msvm_SyntheticEthernetPortSettingData クラス

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

合成イーサネットアダプターの構成済みの状態を表します。

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

構文

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SyntheticEthernetPortSettingData : CIM_EthernetPortAllocationSettingData
{
  string  InstanceID;
  string  Caption = "Virtual Ethernet Port Default Settings";
  string  Description = "Describes the default settings for the virtual Ethernet port resources.";
  string  ElementName;
  uint16  ResourceType = 10;
  string  OtherResourceType;
  string  ResourceSubType = "Microsoft:Hyper-V:Synthetic Ethernet Port";
  string  PoolID;
  uint16  ConsumerVisibility = 3;
  string  HostResource[];
  string  AllocationUnits = "count";
  uint64  VirtualQuantity = 1;
  uint64  Reservation = 1;
  uint64  Limit = 1;
  uint32  Weight = 0;
  boolean AutomaticAllocation = True;
  boolean AutomaticDeallocation = True;
  string  Parent;
  string  Connection[];
  string  Address;
  uint16  MappingBehavior;
  string  AddressOnParent;
  string  VirtualQuantityUnits = "count";
  uint16  DesiredVLANEndpointMode;
  string  OtherEndpointMode;
  string  VirtualSystemIdentifiers[];
  boolean DeviceNamingEnabled = FALSE;
  boolean AllowPacketDirect = FALSE;
  boolean StaticMacAddress = False;
  boolean ClusterMonitored = TRUE;
};

メンバー

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

Properties

プロパティ

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

アドレス

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

リソースのアドレス。たとえば、イーサネットポートの MAC アドレスです。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

AddressOnParent

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

親のコンテキストでのこのリソースのアドレスについて説明します。 Parent プロパティと AddressOnParent プロパティは、コントローラーの関係と、コントローラー上のデバイスの順序を記述するために使用されます。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

AllocationUnits

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

Reservation プロパティと Limit プロパティで使用される割り当ての単位。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

AllowPacketDirect

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

VM に対して PacketDirect プロジェクションが有効になっているかどうかを示します。

注意

Windows 10 バージョン 1703 および Windows Server 2016 で追加されました。

AutomaticAllocation

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

リソースが自動的に割り当てられるかどうかを示します。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

AutomaticDeallocation

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

リソースの割り当てが自動的に解除されるかどうかを示します。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

Caption

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

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

ClusterMonitored

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

このイーサネットアダプターがクラスターによって監視されているかどうかを示します。このプロパティは、構成されていない場合、既定値は true になります。

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

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

接続

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

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

ConsumerVisibility

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

割り当てられたリソースに対するコンシューマーの可視性。このプロパティは CIM_ResourceAllocationSettingDataから継承され、常に 3 (仮想化) に設定されます。

説明

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

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

DesiredVLANEndpointMode

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

VLAN エンドポイントに必要なコンフィギュレーションモード。このプロパティは、対象のイーサネットポートに関連付けられているMsvm_VLANEndpoint クラスのインスタンスで、初期 OperationalEndpointMode プロパティ値を設定するために使用されます。使用可能な値については、Msvm_VLANEndpoint クラスの OperationalEndpointMode プロパティを参照してください。このプロパティは、 CIM_EthernetPortAllocationSettingDataから継承されます。

DeviceNamingEnabled

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

このイーサネットアダプターがデバイスの名前付けをサポートしているかどうかを示します。

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

注意

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

ElementName

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

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

HostResource

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

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

InstanceID

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

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

制限

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

この割り当てに付与されるリソースの上限または最大量。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

MappingBehavior

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

このリソースを基になるリソースにマップする方法を指定します。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

OtherEndpointMode

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

この VLAN エンドポイントでサポートされる VLAN エンドポイントモデルの種類を表す文字列。このプロパティは、 DesiredVLANEndpointMode プロパティが 1 (Other) に設定されている場合にのみ使用されます。 DesiredVLANEndpointMode プロパティが 1 以外の値である場合、このプロパティは Null に設定する必要があります。このプロパティは、 CIM_EthernetPortAllocationSettingDataから継承されます。

OtherResourceType

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

適切に定義された値が使用できなく、ResourceType が "Other" (0) に設定されている場合の リソースの 種類を表す文字列。このプロパティは CIM_ResourceAllocationSettingDataから継承され、使用されません。

Parent

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

リソースの親。たとえば、現在の割り当てのコントローラーです。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

PoolID

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

リソースが現在割り当てられているプール、または割り当てが発生したときにリソースが割り当てられるプール。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

予約

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

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

ResourceSubType

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

このリソースの実装固有のサブタイプを表す文字列。たとえば、これは、同じリソースの種類の異なるモデルを区別するために使用できます。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

ResourceType

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

この設定が適用されるリソースの種類。このプロパティは CIM_ResourceAllocationSettingDataから継承され、常に 10 (イーサネットアダプター) に設定されます。

StaticMacAddress

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

MAC アドレスが静的かどうかを指定します。

VirtualQuantity

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

コンシューマーに提示されるリソースの量。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

VirtualQuantityUnits

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

VirtualQuantity プロパティの測定単位を指定します。このプロパティの値は、DSP0004 V2.5 以降の付録 C.1 で定義されているプログラム単位修飾子の有効な値である必要があります。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

VirtualSystemIdentifiers

データ型: 文字列 配列
アクセスの種類: 読み取り専用
修飾子: ArrayType ("Indexed")

仮想マシンのオペレーティングシステムに提示されるこのリソースの識別子の文字列配列。インデックスとインデックスごとの値は、リソースごとに定義されます (つまり、列挙された ResourceType プロパティ値ごとに)。

Weight

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

同じリソースプールからの他の割り当てに関連するこの割り当ての相対的な優先順位。このプロパティは、 CIM_ResourceAllocationSettingDataから継承されます。

注釈

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

例

「ネットワークオブジェクトのクエリ」を参照してください。

要件

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

こちらもご覧ください

CIM_EthernetPortAllocationSettingData
CIM_ResourceAllocationSettingData

次の方法で共有

Msvm_SyntheticEthernetPortSettingData クラス

構文

メンバー

プロパティ

注釈

例

要件

こちらもご覧ください

フィードバック

その他のリソース