Msvm_EthernetSwitchExtension クラス

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

仮想イーサネットスイッチにバインドされている拡張コンポーネントのインスタンスを表します。

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

構文

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_EthernetSwitchExtension : CIM_EnabledLogicalElement
{
  string   InstanceID;
  string   Caption = "Virtual Switch Extension";
  string   Description;
  string   ElementName;
  datetime InstallDate;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_VirtualEthernetSwitch";
  string   SystemName;
  string   CreationClassName = "Msvm_EthernetSwitchExtension";
  string   Name;
  uint8    ExtensionType;
  string   Vendor;
  string   Version;
};

メンバー

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

メソッド
プロパティ

メソッド

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

メソッド	説明
RequestStateChange	状態の変更を要求します。

プロパティ

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

AvailableRequestedStates

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

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

このプロパティは、 CIM_EnabledLogicalElementから継承されます。

有効 (2)
無効 (3)
シャットダウン (4)
オフライン (6)
テスト (7)
Defer (8)
休止 (9)
再起動 (10)
リセット (11)
DMTF 予約済み (..)

Caption

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

オブジェクトの簡単な説明。このプロパティは CIM_ManagedElementから継承され、常に "仮想スイッチ拡張機能" に設定されます。

CommunicationStatus

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

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

CreationClassName

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

インスタンスの作成で使用されるクラスまたはサブクラスの名前。このプロパティは常に "Msvm_EthernetSwitchExtension" に設定されます。

説明

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

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

DetailedStatus

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

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

ElementName

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

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

EnabledDefault

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

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

有効 (2)
無効 (3)
有効だがオフライン (6)

EnabledState

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

要素の有効および無効の状態。このプロパティは、これらの要求された状態間の遷移を示すこともできます。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

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

ExtensionType

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

拡張コンポーネントの種類を示します。

不明 (0)

キャプチャ (1)

フィルター (2)

転送 (3)

監視 (4)

ネイティブ (5)

HealthState

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

要素の現在の正常性を指定します。この属性は、この要素の正常性を表しますが、必ずしもサブコンポーネントの正常性を表すわけではありません。

重大なエラーが発生した場合は、イベントログをチェックして詳細を確認します。 EnabledState プロパティには、詳細情報を含めることもできます。たとえば、ディスク領域が非常に少ない場合、 HealthState は 25 に設定され、仮想マシンは一時停止し、 EnabledState は 32768 (一時停止) に設定されます。

このプロパティは、 CIM_ManagedSystemElementから継承されます。

値	説明
[OK] 5	要素は完全に機能し、通常の操作パラメーター内で動作しており、エラーはありません。
重大なエラー 20	要素に大きな障害が発生しました。
重大なエラー 25	要素は機能せず、回復できない可能性があります。

InstallDate

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

仮想マシンの構成が作成された日付と時刻。管理オペレーティングシステムの場合は Null です。このプロパティは、 CIM_ManagedSystemElementから継承されます。

InstanceID

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

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

名前

データ型: string
アクセスの種類: 読み取り専用
修飾子: Key、 Override ("Name")、 MaxLen (256)

拡張コンポーネントの一意の名前。

OperatingStatus

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

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

OperationalStatus

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

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

OtherEnabledState

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

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

PrimaryStatus

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

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

RequestedState

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

RequestStateChange メソッドに渡された要素に対して最後に要求された状態または目的の状態。状態の変更が進行中でない場合は 12 (該当なし)。要素の実際の状態は EnabledState で表されます。このプロパティは、最後に要求された状態と現在有効または無効になっている状態を比較するために提供されます。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

状態

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

要素の状態を示す文字列。このプロパティは、 CIM_ManagedSystemElementから継承されます。

StatusDescriptions

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

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

SystemCreationClassName

データ型: string
アクセスの種類: 読み取り専用
修飾子: Key、 伝達済み ("CIM_System。CreationClassName") 、MaxLen (256)

システム作成クラス名。

Systemname

データ型: string
アクセスの種類: 読み取り専用
修飾子: Key、 伝達済み ("CIM_System。Name"), MaxLen (256)

拡張機能インスタンスのバインド先となる仮想スイッチの名前。

TimeOfLastStateChange

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

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

TransitioningToState

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

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

ベンダー名

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

拡張機能を提供するベンダーを示します。

Version

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

"major" の形式の拡張機能のバージョン。minor"( "2.0" など)。

必要条件

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

次の方法で共有