Msvm_ExternalEthernetPort クラス
外部イーサネット ポート (ネットワーク アダプター) を表します。 これらの種類のイーサネット ポートを使用すると、仮想マシンは外部ネットワークにアクセスできます。
次の構文は、簡略化されたマネージ オブジェクト形式 (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 |
|
[DLL] |
|