Msvm_VirtualEthernetSwitch クラス

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

仮想イーサネットスイッチを表します。各スイッチには、ネットワークアダプターを接続できるさまざまなポートがあります。スイッチ自体は高度に構成可能ではなく、ほとんどの場合プレースホルダーとして機能します。

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

構文

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualEthernetSwitch : CIM_ComputerSystem
{
  string   InstanceID;
  string   Caption = "Virtual Switch";
  string   Description = "Microsoft Virtual Switch";
  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   CreationClassName = "Msvm_VirtualEthernetSwitch";
  string   Name = "GUID";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   Roles[];
  string   NameFormat;
  string   OtherIdentifyingInfo[];
  string   IdentifyingDescriptions[];
  uint16   Dedicated[];
  string   OtherDedicatedDescriptions[];
  uint16   ResetCapability = 5;
  uint16   PowerManagementCapabilities[];
  uint32   MaxVMQOffloads;
  uint32   MaxIOVOffloads;
};

メンバー

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

メソッド
プロパティ

メソッド

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

メソッド	説明
RequestStateChange	状態の変更を要求します。
SetPowerState	このメソッドはサポートされていません。

プロパティ

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

AvailableRequestedStates

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

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

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

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

Caption

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

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

CommunicationStatus

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

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

不明 (0)
使用できません (1)
通信 OK (2)
失われた通信 (3)
連絡先なし (4)
DMTF 予約済み (...)
Vendor Reserved (0x8000.. )

CreationClassName

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

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

専用

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

コンピューターシステムが特殊な目的のシステム (特定の用途専用) であるか、汎用システムであるかを示します。このプロパティは CIM_ComputerSystemから継承され、常に 0 (専用ではありません) に設定されます。

説明

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

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

DetailedStatus

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

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

使用できません (0)
追加情報なし (1)
ストレス ( 2)
予測エラー (3)
回復できないエラー (4)
エラーのサポートエンティティ (5)
DMTF 予約済み (...)
Vendor Reserved (0x8000.. )

ElementName

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

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

EnabledDefault

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

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

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

EnabledState

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

要素の有効および無効の状態。このプロパティは、これらの要求された状態間の遷移を示すこともできます。このプロパティは CIM_EnabledLogicalElementから継承され、常に 5 (適用なし) に設定されます。

HealthState

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

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

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

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

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

IdentifyingDescriptions

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

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

InstallDate

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

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

InstanceID

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

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

MaxIOVOffloads

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

このスイッチで使用可能な単一ルート IO 仮想化 (SR-IOV) 仮想関数オフロードの最大数。

MaxVMQOffloads

データ型: uint32
アクセスの種類: 読み取り/書き込み

このスイッチのポートに対して許可される仮想マシンキュー (VMQ) オフロードの最大数。

Name

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

オブジェクトが認識されるラベル。このプロパティは CIM_Systemから継承され、常に "GUID" に設定されます。

NameFormat

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

サブクラスヒューリスティックを使用して、システム名がどのように生成されたかを識別する文字列。このプロパティは CIM_ComputerSystemから継承され、常に Null に設定 されます。

OperatingStatus

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

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

不明 (0)
使用できません (1)
サービス (2)
開始 (3)
停止中 (4)
停止 ( 5)
中止 ( 6)
休止中 (7)
完了 (8)
移行 (9)
Emigrating (10)
Immigrating (11)
スナップショット ( 12)
シャットダウン (13)
In Test (14)
移行中 (15)
In Service (16)
DMTF 予約済み (...)
Vendor Reserved (0x8000.. )

OperationalStatus

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

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

OtherDedicatedDescriptions

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

Dedicated 配列に値 2 (Other) が含まれている場合にシステムが専用になる方法と理由を説明する文字列。このプロパティは CIM_ComputerSystemから継承され、常に Null に設定 されます。

OtherEnabledState

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

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

OtherIdentifyingInfo

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

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

PowerManagementCapabilities

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

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

PrimaryOwnerContact

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

プライマリシステム所有者に到達する方法 (電話番号やメールアドレスなど) を示す文字列。このプロパティは CIM_Systemから継承され、常に Null に設定 されます。

PrimaryOwnerName

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

プライマリシステム所有者の名前。このプロパティは CIM_Systemから継承され、常に Null に設定 されます。

PrimaryStatus

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

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

不明 (0)
OK (1)
低下 ( 2)
エラー (3)
DMTF 予約済み (...)
Vendor Reserved (0x8000.. )

RequestedState

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

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

ResetCapability

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

このプロパティは CIM_ComputerSystemから継承され、常に 5 (実装されていません) に設定されます。

ロール

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

情報技術環境でシステムが果たす役割を記述する文字列の配列。このプロパティは CIM_Systemから継承され、常に Null に設定 されます。

状態

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

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

StatusDescriptions

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

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

TimeOfLastStateChange

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

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

TransitioningToState

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

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

要件

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

次の方法で共有

Msvm_VirtualEthernetSwitch クラス

構文

メンバー

メソッド

プロパティ

要件

フィードバック

その他のリソース