Msvm_EthernetSwitchPort クラス

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

スイッチのポートを表します。

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

構文

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_EthernetSwitchPort : CIM_EthernetPort
{
  string   InstanceID;
  string   Caption = "Ethernet Switch Port";
  string   Description = "Microsoft Virtual Ethernet Switch Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = 2;
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_VirtualEthernetSwitch";
  string   SystemName;
  string   CreationClassName = "Msvm_EthernetSwitchPort";
  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[];
  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[];
  uint32   VMQOffloadUsage;
  uint32   IOVOffloadUsage;
};

メンバー

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

メソッド
プロパティ

メソッド

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

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

プロパティ

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

ActiveMaximumTransmissionUnit

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

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

AdditionalAvailability

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

デバイスの追加の可用性と状態。このプロパティは 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
アクセスの種類: 読み取り専用

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

CommunicationStatus

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

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

CreationClassName

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

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

説明

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

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

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

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

値	説明
有効 2	要素が実行中です。
Disabled 3	要素はオフになっています。

ErrorCleared

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

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

ErrorDescription

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

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

FullDuplex

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

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

HealthState

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

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

IdentifyingDescriptions

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

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

InstallDate

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

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

InstanceID

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

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

IOVOffloadUsage

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

現在の I/O 仮想化 (IOV) は、このポートでの使用量をオフロードします。使用量は、ポートで使用されている IOV リソースの量です。

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
アクセスの種類: 読み取り専用
修飾子: 単位 ("1 秒あたりのビット数")

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

Name

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

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

NetworkAddresses

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

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

OperatingStatus

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

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

OperationalStatus

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

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

OtherEnabledCapabilities

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

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

OtherEnabledState

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

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

OtherIdentifyingInfo

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

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

OtherLinkTechnology

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

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

OtherNetworkPortType

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

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

OtherPortType

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

PortType が 1 (その他) に設定されている場合のモジュールの種類について説明します。このプロパティは、 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)
Vendor Reserved (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 秒あたりのビット数")

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

状態

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

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

StatusDescriptions

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

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

StatusInfo

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

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

SupportedMaximumTransmissionUnit

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

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

SystemCreationClassName

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

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

Systemname

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

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

TimeOfLastStateChange

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

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

TotalPowerOnHours

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

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

TransitioningToState

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

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

UsageRestriction

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

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

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

VMQOffloadUsage

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

このポートでの使用量をオフロードしている現在の仮想マシンキュー (VMQ)。使用量は、ポートで使用されている VMQ リソースの量です。

要件

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

次の方法で共有

Msvm_EthernetSwitchPort クラス

構文

メンバー

メソッド

プロパティ

要件

フィードバック

その他のリソース