Msvm_ExternalEthernetPort クラス

[アーティクル]
07/03/2023

外部イーサネットポート (ネットワークアダプター) を表します。これらの種類のイーサネットポートを使用すると、仮想マシンは外部ネットワークにアクセスできます。

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

構文

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_ExternalEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Port";
  string   Description = "Microsoft External Ethernet Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[] = "OK";
  string   Status = "OK";
  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_ExternalEthernetPort";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  string   AdditionalAvailability[];
  uint64   MaxQuiesceTime;
  uint64   Speed;
  uint64   MaxSpeed;
  uint64   RequestedSpeed;
  uint16   UsageRestriction;
  uint16   PortType;
  string   OtherPortType;
  string   OtherNetworkPortType;
  uint16   PortNumber;
  uint16   LinkTechnology;
  string   OtherLinkTechnology;
  string   PermanentAddress;
  string   NetworkAddresses[];
  boolean  FullDuplex;
  boolean  AutoSense;
  uint64   SupportedMaximumTransmissionUnit;
  uint64   ActiveMaximumTransmissionUnit;
  uint32   MaxDataSize;
  uint16   Capabilities[];
  string   CapabilityDescriptions[];
  uint16   EnabledCapabilities[];
  string   OtherEnabledCapabilities[];
  boolean  IsBound;
};

メンバー

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

メソッド
プロパティ

メソッド

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

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

プロパティ

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

ActiveMaximumTransmissionUnit

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

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

AdditionalAvailability

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

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

AutoSense

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

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

可用性

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

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

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

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

CapabilityDescriptions

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

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

Caption

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

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

CommunicationStatus

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

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

CreationClassName

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

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

説明

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

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

DetailedStatus

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

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

DeviceID

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

論理デバイスに一意の名前を付けるアドレスまたはその他の識別情報。このプロパティは 、CIM_LogicalDeviceから継承されます。

ElementName

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

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

EnabledCapabilities

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

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

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

EnabledDefault

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

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

EnabledState

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

要素の有効および無効の状態。また、これらの要求された状態間の遷移を示すこともできます。たとえば、シャットダウン (4) と開始 (10) は、有効と無効の間の一時的な状態です。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

値	説明
Unknown 0
その他 1
有効 2	要素がまたはコマンドを実行している可能性があり、キューに登録されたコマンドが処理され、新しい要求がキューに入れられます。
Disabled 3	要素はコマンドを実行せず、新しい要求を削除します。
シャットダウン 4	要素は、Disabled 状態になる処理中です。
該当なし 5	要素は、有効または無効をサポートしていません。
有効だがオフライン 6	要素はコマンドを完了している可能性があり、新しい要求はすべて削除されます。
テスト中 7	要素はテスト状態です。
遅延 8	要素はコマンドを完了している可能性がありますが、新しい要求はキューに入れられます。
休止 9	要素は有効ですが、制限付きモードです。要素の動作は Enabled 状態に似ていますが、制限されたコマンドセットのみを処理します。その他の要求はすべてキューに入れられます。
開始中 10	要素は、Enabled 状態に移動する処理中です。新しい要求がキューに入れられます。
DMTF 予約済み 11 32767	予約済み。
ベンダー予約済み 32768 65535	予約済み。

ErrorCleared

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

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

ErrorDescription

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

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

FullDuplex

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

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

HealthState

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

要素の現在の正常性。この属性は、この要素の正常性を表しますが、必ずしもサブコンポーネントの正常性を表すわけではありません。指定できる値は 0 から 30 です。5 は要素が完全に正常であることを意味し、30 は要素が完全に非機能であることを意味します。このプロパティは CIM_ManagedSystemElementから継承され、常に 5 (OK) に設定されます。

IdentifyingDescriptions

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

OtherIdentifyingInfo プロパティ配列のエントリの背後にある説明と詳細を提供する自由形式の文字列の配列。このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

InstallDate

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

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

InstanceID

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

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

IsBound

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

このプロパティが True の場合、このイーサネットポートをスイッチに接続できるため、仮想マシンへの接続を提供できます。このプロパティが False の場合、このイーサネットポートは仮想マシンネットワークアーキテクチャでは使用されません。

LastErrorCode

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

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

LinkTechnology

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

ポートのリンクテクノロジの種類を指定します。 1 (Other) に設定すると、 OtherLinkTechnology プロパティにはリンクの種類の文字列の説明が含まれます。このプロパティは、 CIM_NetworkPortから継承されます。

不明 (0)
その他 (1)
イーサネット (2)
IB (3)
FC (4)
FDDI (5)
ATM (6)
トークンリング (7)
フレームリレー (8)
赤外線 (9)
BlueTooth (10)
ワイヤレス LAN (11)

MaxDataSize

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

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

MaxQuiesceTime

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

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

MaxSpeed

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

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

名前

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

オブジェクトが認識されるラベル。このプロパティは 、CIM_ManagedSystemElementから継承されます。

NetworkAddresses

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

ポートの MAC アドレスを含む文字列の配列。このプロパティは、 CIM_NetworkPortから継承されます。

OperatingStatus

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

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

OperationalStatus

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

オブジェクトの現在の状態。このプロパティは CIM_ManagedSystemElementから継承され、各配列要素は常に 2 (OK) に設定されます。

OtherEnabledCapabilities

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

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

OtherEnabledState

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

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

OtherIdentifyingInfo

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

論理デバイスを識別するために使用できる、デバイス ID 情報以外の追加データ。このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

OtherLinkTechnology

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

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

OtherNetworkPortType

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

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

OtherPortType

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

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

PermanentAddress

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

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

PortNumber

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

ポート番号。このプロパティは、 CIM_NetworkPortから継承されます。

Porttype

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

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

不明 (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

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

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

PowerOnHours

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

前回の電源サイクル以降にこのデバイスの電源がオンになっている連続した時間数。このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

PrimaryStatus

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

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

RequestedSpeed

データ型: uint64
アクセスの種類: 読み取り専用
修飾子: 単位 ("1 秒あたりのビット数")

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

RequestedState

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

要素に対して最後に要求された状態または目的の状態。このプロパティは CIM_EnabledLogicalElementから継承され、常に 12 (適用できません) に設定されます。

速度

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

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

状態

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

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

"OK"
わかりました
エラー
劣化
未知
Pred Fail
開始
停止
サービス
強調
NonRecover
連絡先なし
失われた通信

StatusDescriptions

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

さまざまな OperationalStatus 配列値を記述する文字列。このプロパティは CIM_ManagedSystemElementから継承され、各配列要素は常に "OK" に設定されます。

StatusInfo

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

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

SupportedMaximumTransmissionUnit

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

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

SystemCreationClassName

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

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

Systemname

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

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

TimeOfLastStateChange

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

要素の有効な状態が最後に変更された日時。このプロパティは CIM_EnabledLogicalElementから継承され、常に Null に設定 されます。

TotalPowerOnHours

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

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

TransitioningToState

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

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

UsageRestriction

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

状況によっては、論理ポートがフロントエンドまたはバックエンドポートとして識別される場合があります。この状況の例として、ディスクドライブと通信するためのバックエンドポートとホストと通信するフロントエンドポートがあるストレージアレイがあります。ポートの使用に制限がない場合は、値を "制限なし" に設定する必要があります。このプロパティは、 CIM_LogicalPortから継承されます。

不明 (0)
フロントエンドのみ (2)
バックエンドのみ (3)
制限なし (4)

注釈

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

例

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

要件

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

次の方法で共有

Msvm_ExternalEthernetPort クラス

構文

メンバー

メソッド

プロパティ

注釈

例

要件

関連項目

フィードバック

その他のリソース