Msvm_EmulatedEthernetPort クラス

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

エミュレートされたイーサネットアダプターを表します。このアダプターは、ゲストに統合回線がインストールされていない場合に、仮想マシンが合成イーサネットポートを実行できない場合に使用されます。

注意

このクラスは、第 2 世代仮想マシンでは使用できません。

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

構文

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_EmulatedEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Port";
  string   Description = "Microsoft Emulated Ethernet Port";
  string   ElementName = "Legacy Network Adapter";
  datetime InstallDate;
  string   Name = "Ethernet Port";
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[] = "OK";
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_EmulatedEthernetPort";
  string   DeviceID = "Microsoft:GUID\device-specific data";
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint16   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = 6;
  uint64   MaxQuiesceTime;
  uint64   Speed = 1000000000;
  uint64   MaxSpeed = 1000000000;
  uint64   RequestedSpeed = 1000000000;
  uint16   UsageRestriction = 4;
  uint16   PortType = 1;
  string   OtherPortType = "Virtual Ethernet";
  string   OtherNetworkPortType;
  uint16   PortNumber;
  uint16   LinkTechnology = 2;
  string   OtherLinkTechnology;
  string   PermanentAddress;
  string   NetworkAddresses[];
  boolean  FullDuplex = True;
  boolean  AutoSense = True;
  string   SupportedMaximumTransmissionUnit = 1500;
  uint64   ActiveMaximumTransmissionUnit = 1500;
  uint32   MaxDataSize = 1500;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  uint16   EnabledCapabilities[];
  string   OtherEnabledCapabilities[];
};

メンバー

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

メソッド
プロパティ

メソッド

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

メソッド	説明
EnableDevice	このメソッドはサポートされていません。
OnlineDevice	このメソッドはサポートされていません。
QuiesceDevice	このメソッドはサポートされていません。
RequestStateChange	状態の変更を要求します。
リセット	エミュレートされたデバイスをリセットします。
RestoreProperties	このメソッドはサポートされていません。
SaveProperties	このメソッドはサポートされていません。
SetPowerState	このメソッドはサポートされていません。

プロパティ

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

ActiveMaximumTransmissionUnit

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

サポートできるアクティブまたはネゴシエートされた最大伝送ユニット (MTU)。このプロパティは CIM_NetworkPortから継承され、常に 1500 に設定されます。

AdditionalAvailability

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

デバイスの追加の可用性と状態。 Availability プロパティで指定されている状態を超えています。このプロパティは CIM_LogicalDeviceから継承され、常に 6 ("適用なし") に設定されます。

AutoSense

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

ネットワークポートが、接続されているネットワークメディアの速度やその他の通信特性を自動的に決定できるかどうかを示します。このプロパティは CIM_NetworkPortから継承され、常に True に設定されます。

可用性

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

デバイスのプライマリ可用性と状態。このプロパティは CIM_LogicalDeviceから継承され、常に Null に設定 されます。

AvailableRequestedStates

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

状態変更の開始に使用される RequestStateChange メソッドの RequestedState パラメーターに使用できる値を示します。一覧表示される値は、CIM_EnabledLogicalElementCapabilitiesの関連付けられたインスタンスの RequestedStatesSupported プロパティに含まれる 値のサブセットになります。ここで、選択した値は 、CIM_EnabledLogicalElementの現在の状態の関数です。実装で使用可能な値のセットを現在の状態の関数としてアドバタイズできる場合、このプロパティは Null 以外にすることができます。実装が現在の状態の関数として使用可能な値のセットを判断できない場合、このプロパティは Null になります 。

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

有効 (2)
無効 (3)
シャットダウン (4)
オフライン (6)
テスト (7)
Defer (8)
休止 (9)
再起動 (10)
リセット (11)
DMTF 予約済み (..)

Capabilities

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

イーサネットポートの機能。このプロパティは CIM_EthernetPort から継承され、使用されません。

CapabilityDescriptions

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

Capabilities 配列に示されているイーサネットポート機能の詳細な説明を提供するフリーフォーム文字列の配列。この配列の各エントリは、同じインデックスにある Capabilities 配列内のエントリに関連しています。このプロパティは CIM_EthernetPort から継承され、使用されません。

Caption

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

オブジェクトの簡単な説明。このプロパティは CIM_ManagedElementから継承され、常に "イーサネットポート" に設定されます。

CommunicationStatus

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

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

CreationClassName

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

インスタンスの作成で使用されるクラスまたはサブクラスの名前。このクラスの他のキープロパティと共に使用する場合、このプロパティを使用すると、このクラスとそのサブクラスのすべてのインスタンスを一意に識別できます。このプロパティは CIM_LogicalDeviceから継承され、常に "Msvm_EmulatedEthernetPort" に設定されます。

説明

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

オブジェクトの説明。このプロパティは CIM_ManagedElementから継承され、常に "Microsoft エミュレートイーサネットポート" に設定されます。

DetailedStatus

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

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

DeviceID

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

論理デバイスに一意の名前を付けるために使用されるアドレスまたはその他の識別情報。このプロパティは CIM_LogicalDeviceから継承され、常に "Microsoft:GUID\デバイス固有のデータ" に設定されます。

ElementName

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

オブジェクトの表示名。このプロパティは CIM_ManagedElementから継承され、常に "レガシネットワークアダプター" に設定されます。

EnabledCapabilities

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

Capabilities 配列で定義されているすべてのサポート対象の機能の一覧から有効になっている機能。このプロパティは CIM_EthernetPortから継承されますが、使用されません。

EnabledDefault

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

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

EnabledState

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

要素の有効および無効の状態。このプロパティは CIM_EnabledLogicalElementから継承され、常に 5 ("適用不可" ) に設定されます。

ErrorCleared

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

LastErrorCode で報告されたエラーがクリアされたかどうかを示します。このプロパティは CIM_LogicalDevice から継承され、使用されません。

ErrorDescription

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

LastErrorCode に記録されたエラーに関する詳細情報と、実行できる修正アクションに関する情報を提供する文字列。このプロパティは CIM_LogicalDevice から継承され、使用されません。

FullDuplex

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

ポートが全二重モードで動作しているかどうかを示します。このプロパティは CIM_NetworkPortから継承され、常に True に設定 されます。

HealthState

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

要素の現在の正常性。この属性は、この要素の正常性を表しますが、必ずしもサブコンポーネントの正常性を表すわけではありません。このプロパティは CIM_ManagedSystemElementから継承され、常に 5 ("OK") に設定されます。

IdentifyingDescriptions

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

OtherIdentifyingInfo 配列のエントリの背後にある説明と詳細を提供する自由形式の文字列の配列。この配列の各エントリは、同じインデックスにある OtherIdentifyingInfo 内のエントリに関連しています。このプロパティは CIM_LogicalDevice から継承され、使用されません。

InstallDate

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

オブジェクトがインストールされた日時を示す datetime 値。値がない場合、オブジェクトがインストールされていないことを示すわけではありません。このプロパティは、 CIM_ManagedSystemElementから継承されます。

InstanceID

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

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

LastErrorCode

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

論理デバイスによって報告された最後のエラーコード。このプロパティは CIM_LogicalDevice から継承され、使用されません。

LinkTechnology

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

リンクの種類。 1 ("Other") に設定すると、関連プロパティ OtherLinkTechnology には、リンクの種類の文字列の説明が含まれます。このプロパティは CIM_NetworkPort から継承され、常に 2 ("イーサネット") に設定されます。

MaxDataSize

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

受信または送信される INFO (MAC 以外) フィールドの最大サイズ。このプロパティは CIM_EthernetPortから継承され、常に 1500 に設定されます。

MaxQuiesceTime

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

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

MaxSpeed

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

ポートの最大帯域幅 (1 秒あたりのビット数)。このプロパティは CIM_LogicalPortから継承され、常に 10000000000 に設定されます。

Name

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

オブジェクトが認識されるラベル。サブクラス化すると、このプロパティをキープロパティとしてオーバーライドできます。このプロパティは CIM_ManagedSystemElementから継承され、常に "イーサネットポート" に設定されます。

NetworkAddresses

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

イーサネット/802.3 MAC アドレス。12 桁の 16 進数 (例: "010203040506") で書式設定され、各ペアは MAC アドレスの 6 オクテットの 1 つを正規ビット順で表します (グループアドレスビットは、文字列の最初の文字の下位ビットにあります)。このプロパティは CIM_EthernetPort から継承され、使用されません。

OperatingStatus

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

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

OperationalStatus

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

要素の現在の状態。このプロパティは CIM_ManagedSystemElementから継承され、常に 2 ("OK") に設定されます。

OtherEnabledCapabilities

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

"Other" として指定されている有効な機能の詳細な説明を提供する自由形式文字列の配列。このプロパティは CIM_EthernetPort から継承され、使用されません。

OtherEnabledState

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

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

OtherIdentifyingInfo

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

デバイス ID 情報に加えて、論理デバイスを識別するために使用できるデータ。たとえば、このプロパティを使用して、デバイスのオペレーティングシステムの表示名を保持できます。このプロパティは CIM_LogicalDevice から継承され、使用されません。

OtherLinkTechnology

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

LinkTechnology が 1 ("Other") に設定されている場合に説明する文字列値。このプロパティは CIM_NetworkPortから継承されますが、使用されません。

OtherNetworkPortType

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

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

OtherPortType

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

PortType が 1 ("Other") に設定されている場合のモジュールの種類。このプロパティは CIM_LogicalPort から継承され、常に "Virtual Ethernet" に設定されます。

PermanentAddress

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

ポートにハードコーディングされたネットワークアドレス。このアドレスは、ファームウェアのアップグレードまたはソフトウェア構成を使用して変更できます。この変更が行われると、フィールドを同時に更新する必要があります。ネットワークアダプターにハードコーディングされたアドレスが存在しない場合は、空白のままにする必要があります。このプロパティは、 CIM_NetworkPortから継承されます。

PortNumber

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

ネットワークポートは、多くの場合、論理モジュールまたはネットワーク要素に対して相対的に番号が付けられます。このプロパティは、 CIM_NetworkPortから継承されます。

値	説明
0	NIC はエミュレートされません。
1	NIC はエミュレートされます。

Porttype

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

ポートに対して現在有効になっている特定のモード。 1 ("Other") に設定すると、関連プロパティ OtherPortType にはポートの種類の文字列の説明が含まれます。このプロパティは CIM_EthernetPortから継承され、常に 1 ("Other") に設定されます。

PowerManagementCapabilities

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

デバイスの電源管理機能。このプロパティは CIM_LogicalDevice から継承され、使用されません。

PowerManagementSupported

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

デバイスを電源管理できるかどうかを示します。このプロパティは CIM_LogicalDevice から継承され、使用されません。

PowerOnHours

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

このデバイスが最後の電源サイクル以降に電源を供給された連続した時間数。このプロパティは CIM_LogicalDevice から継承され、使用されません。

PrimaryStatus

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

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

RequestedSpeed

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

ポートの要求された帯域幅 (ビット/秒)。実際の帯域幅は LogicalPort.Speed で報告されます。このプロパティは CIM_LogicalPortから継承され、常に 10000000000 に設定されます。

RequestedState

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

管理サービスに対して最後に要求された状態または必要な状態。 EnabledState が 5 ("適用不可") に設定されている場合、このプロパティは意味がありません。このプロパティは CIM_EnabledLogicalElementから継承され、常に 12 に設定されます ("適用できません")。

速度

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

ポートの現在の帯域幅 (1 秒あたりのビット数)。帯域幅が異なるポート、または正確な推定ができないポートの場合は、このプロパティに公称帯域幅を含める必要があります。このプロパティは CIM_NetworkPortから継承され、常に 10000000000 に設定されます。

状態

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

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

StatusDescriptions

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

さまざまな OperationalStatus 配列値を記述する文字列。この配列内のエントリは、 OperationalStatus の同じ配列インデックスにあるエントリと相関します。このプロパティは CIM_ManagedSystemElementから継承され、常に "OK" に設定されます。

StatusInfo

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

論理デバイスの状態。このプロパティは CIM_LogicalDevice から継承され、使用されません。

SupportedMaximumTransmissionUnit

データ型: string
アクセスの種類: 読み取り専用
修飾子: Units ("Bytes")

サポートできる最大伝送単位 (MTU) (バイト単位)。このプロパティは CIM_NetworkPortから継承され、常に 1500 に設定されます。

SystemCreationClassName

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

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

Systemname

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

GUID 形式の仮想マシン ID。このプロパティは、 CIM_LogicalDeviceから継承されます。

TimeOfLastStateChange

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

要素の EnabledState が最後に変更された日時。要素の状態が変更されておらず、このプロパティが設定されている場合は、0 間隔の値に設定する必要があります。状態の変更が要求されたが、拒否されたか、まだ処理されていない場合、プロパティを更新することはできません。このプロパティは CIM_EnabledLogicalElement から継承され、使用されません。

TotalPowerOnHours

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

このデバイスの電源が入っている合計時間数。このプロパティは CIM_LogicalDevice から継承され、使用されません。

TransitioningToState

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

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

UsageRestriction

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

状況によっては、論理ポートがフロントエンドまたはバックエンドポートとして識別される場合があります。ポートの使用に制限がない場合は、値を 4 ("制限なし") に設定する必要があります。このプロパティは 、CIM_LogicalPort から継承され、常に 4 ("制限なし") に設定されます。

注釈

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

例

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

要件

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

こちらもご覧ください

CIM_EthernetPort
CIM_EthernetPort

次の方法で共有