Msvm_InternalEthernetPort クラス

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

内部イーサネットポート (ネットワークアダプター) を表します。この種類のイーサネットポートを使用すると、仮想マシンはネットワークソフトウェアを実行している仮想化サーバーにアクセスできます。内部ネットワークアダプターを使用すると、物理システムから出る前に、仮想マシンのネットワークトラフィックをルーティングまたはフィルター処理できます。

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

構文

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_InternalEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Port";
  string   Description = "Microsoft Internal Ethernet Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  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_InternalEthernetPort";
  string   DeviceID;
  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   MaxSpeed = 1000000000;
  uint64   RequestedSpeed = 1000000000;
  uint16   UsageRestriction = 4;
  string   OtherPortType;
  uint64   Speed;
  string   OtherNetworkPortType;
  uint16   PortNumber;
  uint16   LinkTechnology = 2;
  string   OtherLinkTechnology;
  string   PermanentAddress;
  boolean  FullDuplex = True;
  boolean  AutoSense = True;
  uint64   SupportedMaximumTransmissionUnit = 1500;
  uint64   ActiveMaximumTransmissionUnit = 1500;
  uint16   PortType;
  string   NetworkAddresses[];
  uint32   MaxDataSize = 1500;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  uint16   EnabledCapabilities[];
  string   OtherEnabledCapabilities[];
};

メンバー

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

メソッド
プロパティ

メソッド

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

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

プロパティ

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

ActiveMaximumTransmissionUnit

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

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

AdditionalAvailability

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

デバイスの追加の可用性と状態は、 Availability プロパティで指定された値を超えています。このプロパティは、 CIM_LogicalDeviceから継承されます。

AutoSense

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

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

可用性

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

デバイスのプライマリ可用性と状態。このプロパティは CIM_LogicalDevice から継承され、使用されません。

AvailableRequestedStates

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

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

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

Capabilities

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

イーサネットポートの機能。フェールオーバーまたは負荷分散機能が一覧表示されている場合は、機能を完全に説明するために 、CIM_SpareGroup (フェールオーバー) またはCIM_ExtraCapacityGroup (負荷分散) も定義する必要があります。このプロパティは、 CIM_EthernetPortから継承されます。

不明 (0)
その他 (1)
AlertOnLan (2)
WakeOnLan (3)
FailOver (4)
LoadBalancing (5)

CapabilityDescriptions

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

Capabilities 配列に示されているイーサネットポート機能の詳細な説明を提供する自由形式の文字列の配列。この配列の各エントリは、同じインデックスにある Capabilities 配列内のエントリに関連付けられていることに注意してください。このプロパティは、 CIM_EthernetPortから継承されます。

Caption

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

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

CommunicationStatus

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

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

CreationClassName

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

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

説明

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

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

DetailedStatus

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

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

DeviceID

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

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

ElementName

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

オブジェクトの表示名。このプロパティを使用すると、各インスタンスは、主要なプロパティ、ID データ、説明情報に加えて表示名を定義できます。このプロパティは CIM_ManagedElement から継承され、ホストに存在する NIC に基づいて生成されます。

EnabledCapabilities

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

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

不明 (0)
その他 (1)
AlertOnLan (2)
WakeOnLan (3)
FailOver (4)
LoadBalancing (5)

EnabledDefault

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

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

EnabledState

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

要素の有効および無効の状態。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

ErrorCleared

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

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

ErrorDescription

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

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

FullDuplex

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

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

HealthState

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

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

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から継承されます。

MaxQuiesceTime

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

このプロパティは非推奨とされました。このプロパティは CIM_LogicalDevice から継承され、使用されません。

MaxSpeed

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

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

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から継承されます。

OtherEnabledCapabilities

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

1 (その他) として指定されている有効な機能の詳細な説明を提供する自由形式の文字列の配列。このプロパティは、 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
アクセスの種類: 読み取り専用

このプロパティの使用は非推奨とされます。 PortType プロパティを使用します。このプロパティは、 CIM_NetworkPortから継承されます。

非推奨の説明: PortType プロパティが 1 (その他) に設定されている場合のモジュールの種類。

OtherPortType

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

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

PermanentAddress

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

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

PortNumber

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

多くの場合、ネットワークポートには、論理モジュールまたはネットワーク要素に関連する番号が付けられます。この値は、エミュレートされた NIC の場合は 1、それ以外の場合は 0 です。このプロパティは、 CIM_NetworkPortから継承されます。

Porttype

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

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

不明 (0)
その他 (1)
//50 銅 10BaseT (50)
10 から 100BaseT (51)
100BaseT (52)
1000BaseT (53)
2500BaseT (54)
10GBaseT (55)
10GBase-CX4 (56)
//100 ファイバー 100Base-FX (100)
100Base-SX (101)
1000Base-SX (102)
1000Base-LX (103)
1000Base-CX (104)
10GBase-SR (105)
10GBase-SW (106)
10GBase-LX4 (107)
10GBase-LR (108)
10GBase-LW (109)
10GBase-ER (110)
10GBase-EW (111)
仕入先予約 済み (16000 65535)

PowerManagementCapabilities

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

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

PowerManagementSupported

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

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

PowerOnHours

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

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

PrimaryStatus

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

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

RequestedSpeed

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

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

RequestedState

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

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

速度

データ型: uint64
アクセスの種類: 読み取り専用
修飾子: オーバーライド、単位 ("ビット/秒")

ポートの現在の帯域幅 (ビット/秒)。帯域幅が異なるポート、または正確な見積もりができないポートの場合、このプロパティには呼び出し帯域幅を含める必要があります。このプロパティは、 CIM_NetworkPortから継承されます。

状態

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

オブジェクトの現在の状態。このプロパティは CIM_ManagedSystemElementから継承されますが、使用されません。

StatusDescriptions

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

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

StatusInfo

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

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

SupportedMaximumTransmissionUnit

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

サポートできる最大伝送ユニット (MTU)。このプロパティは、 CIM_NetworkPortから継承されます。

SystemCreationClassName

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

スコープシステムの作成クラス名。このプロパティは CIM_LogicalDeviceから継承されますが、サポートされていません

Systemname

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

スコープシステムの名前。このプロパティは 、CIM_LogicalDeviceから継承されます。

TimeOfLastStateChange

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

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

TotalPowerOnHours

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

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

TransitioningToState

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

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

UsageRestriction

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

状況によっては、論理ポートがフロントエンドまたはバックエンドポートとして識別される場合があります。このプロパティは、 CIM_LogicalPortから継承されます。

値	説明
4	制限なし

注釈

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

例

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

要件

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

こちらもご覧ください

CIM_EthernetPort
CIM_EthernetPort

次の方法で共有

Msvm_InternalEthernetPort クラス

構文

メンバー

メソッド

プロパティ

注釈

例

要件

こちらもご覧ください

フィードバック

その他のリソース