Msvm_SyntheticEthernetPort クラス

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

合成イーサネットアダプターを表します。このアダプターは、パフォーマンスが高く、使用中 (ホットコンフィギュラビリティ) 中にすぐに有効になるため、推奨されるネットワークアダプターです。

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

構文

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SyntheticEthernetPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName;
  string   SystemName;
  string   CreationClassName;
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = 6;
  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[];
};

メンバー

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

メソッド
プロパティ

メソッド

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

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

プロパティ

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

ActiveMaximumTransmissionUnit

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

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

AdditionalAvailability

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

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

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 配列
アクセスの種類: 読み取り専用

イーサネットポートの機能。たとえば、デバイスで AlertOnLan、WakeOnLan、負荷分散、または FailOver がサポートされている場合があります。フェールオーバーまたは負荷分散機能が一覧表示されている場合は、機能を完全に記述するために、SpareGroup (フェールオーバー) または ExtraCapacityGroup (負荷分散) も定義する必要があります。このプロパティは CIM_EthernetPort から継承され、使用されません。

CapabilityDescriptions

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

Capabilities プロパティ配列に示されている EthernetPort 機能の詳細な説明を提供する、自由形式の文字列の配列。この配列の各エントリは、同じインデックスにある 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から継承されます。

ElementName

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

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

EnabledCapabilities

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

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

EnabledDefault

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

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

EnabledState

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

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

ErrorCleared

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

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

ErrorDescription

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

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

FullDuplex

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

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

HealthState

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

要素の現在の正常性。このプロパティは、 CIM_ManagedSystemElementから継承されます。

IdentifyingDescriptions

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

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

InstallDate

データ型: 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 秒あたりのビット数")

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

名前

データ型: 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) に設定されている場合の要素の有効または無効の状態。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

OtherIdentifyingInfo

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

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

OtherLinkTechnology

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

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

OtherNetworkPortType

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

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

OtherPortType

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

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

PermanentAddress

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

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

PortNumber

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

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

Porttype

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

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

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
アクセスの種類: 読み取り専用

管理サービスに対して最後に要求された状態または必要な状態。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

速度

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

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

状態

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

要素の現在の状態。このプロパティは、 CIM_ManagedSystemElementから継承されます。

StatusDescriptions

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

さまざまな OperationalStatus 配列値を記述する文字列。このプロパティは、 CIM_ManagedSystemElementから継承されます。

StatusInfo

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

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

SupportedMaximumTransmissionUnit

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

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

SystemCreationClassName

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

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

Systemname

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

ホスティングコンピューターシステムの NetBIOS 名。このプロパティには、 GUID 形式の仮想マシン ID が含まれます。このプロパティは、 CIM_LogicalDeviceから継承されます。

TimeOfLastStateChange

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

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

TotalPowerOnHours

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

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

TransitioningToState

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

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

UsageRestriction

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

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

注釈

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

例

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

要件

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

こちらもご覧ください

CIM_EthernetPort
CIM_EthernetPort

次の方法で共有

Msvm_SyntheticEthernetPort クラス

構文

メンバー

メソッド

プロパティ

注釈

例

要件

こちらもご覧ください

フィードバック

その他のリソース