Msvm_SerialController クラス

シリアル コントローラーの機能と管理を表します。 シリアル コントローラーは、仮想マシンに常に存在する論理デバイスであるため、リソース プールを介して割り当てられません。 1 つのシリアル コントローラー インスタンスは、常に仮想マシンに存在します。 シリアル コントローラーには、固定数のポート インスタンスがあります。 この実装では、コントローラーごとに 2 つのポートがサポートされています。

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

構文

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SerialController : CIM_SerialController
{
  string   InstanceID;
  string   Caption = "Serial Controller";
  string   Description = "Microsoft Virtual Serial Controller";
  string   ElementName = "Serial Controller";
  datetime InstallDate;
  string   Name = "Serial Controller";
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "OK" };
  string   Status;
  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_SerialController";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability = 6;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  datetime TimeOfLastReset;
  uint16   ProtocolSupported = 26;
  uint32   MaxNumberControlled = 2;
  string   ProtocolDescription;
  uint16   Capabilities[] = { 5 };
  string   CapabilityDescriptions[] = { "16550 compatible" };
  uint32   MaxBaudRate = 115200;
  uint16   Security = 3;
};

メンバー

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

• メソッド
• プロパティ

メソッド

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

プロパティ

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

AdditionalAvailability

データ型: uint16 配列

アクセスの種類: 読み取り専用

デバイスの追加の可用性と状態。 このプロパティは 、CIM_LogicalDeviceから継承されます。

値	説明
{ 6 }
6	適用しない

可用性

データ型: uint16

アクセスの種類: 読み取り専用

デバイスのプライマリ可用性と状態。 このプロパティは 、CIM_LogicalDeviceから継承されます。

値	説明
6	適用しない

AvailableRequestedStates

データ型: uint16 配列

アクセスの種類: 読み取り専用

RequestStateChange メソッドの RequestedState パラメーターに使用できる値を示します。 このプロパティは CIM_EnabledLogicalElementから継承されますが、使用されません。

Capabilities

データ型: uint16 配列

アクセスの種類: 読み取り専用

チップ ハードウェアに固有のシリアル コントローラーのバッファリングとその他の機能。 このプロパティは、 CIM_SerialControllerから継承されます。

CapabilityDescriptions

データ型: 文字列 配列

アクセスの種類: 読み取り専用

Capabilities 配列に示されているシリアル コントローラー機能の詳細な説明を提供する自由形式文字列の配列。 このプロパティは、 CIM_SerialControllerから継承されます。

Caption

データ型: string

アクセスの種類: 読み取り専用

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

CommunicationStatus

データ型: uint16

アクセスの種類: 読み取り専用

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

不明 (0)

使用できません (1)

通信 OK (2)

失われた通信 (3)

連絡先なし (4)

DMTF 予約済み (..)

ベンダー予約 済み (0x8000.. )

CreationClassName

データ型: string

アクセスの種類: 読み取り専用

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

説明

データ型: string

アクセスの種類: 読み取り専用

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

DetailedStatus

データ型: uint16

アクセスの種類: 読み取り専用

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

使用できません (0)

追加情報なし (1)

ストレス ( 2)

予測エラー (3)

回復できないエラー (4)

エラーのサポート エンティティ (5)

DMTF 予約済み (...)

Vendor Reserved (0x8000.. )

DeviceID

データ型: string

アクセスの種類: 読み取り専用

このプロパティは CIM_LogicalDeviceから継承され、常に "Microsoft:<GUID>" に設定されます。

ElementName

データ型: string

アクセスの種類: 読み取り専用

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

EnabledDefault

データ型: uint16

アクセスの種類: 読み取り専用

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

値	意味
2	Enabled

EnabledState

データ型: uint16

アクセスの種類: 読み取り専用

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

値	説明
5	適用しない

ErrorCleared

データ型: ブール値

アクセスの種類: 読み取り専用

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

ErrorDescription

データ型: string

アクセスの種類: 読み取り専用

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

HealthState

データ型: uint16

アクセスの種類: 読み取り専用

要素の現在の正常性。 これは、この要素の正常性を表しますが、必ずしもサブコンポーネントの正常性を表すわけではありません。 指定できる値は 0 ~ 30 で、5 は要素が完全に正常であることを意味し、30 は要素が完全に非機能であることを意味します。 このプロパティは、 CIM_ManagedSystemElementから継承されます。

IdentifyingDescriptions

データ型: 文字列 配列

アクセスの種類: 読み取り専用

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

InstallDate

データ型: datetime

アクセスの種類: 読み取り専用

仮想マシン構成が作成された日時。 このプロパティは、 CIM_ManagedSystemElementから継承されます。

InstanceID

データ型: string

アクセスの種類: 読み取り専用

修飾子: キー

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

LastErrorCode

データ型: uint32

アクセスの種類: 読み取り専用

論理デバイスによって報告された最後のエラー コード。 このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

MaxBaudRate

データ型: uint32

アクセスの種類: 読み取り専用

シリアル コントローラーでサポートされる最大ボー レート (1 秒あたりのビット数)。 このプロパティは、 CIM_SerialControllerから継承されます。

MaxNumberControlled

データ型: uint32

アクセスの種類: 読み取り専用

このコントローラーでサポートされている直接アドレス指定可能なエンティティの最大数。 数値が不明または無制限の場合は、値 0 を使用する必要があります。 コントローラーが制御されたデバイスにアクセスするために使用するプロトコル。 このプロパティは 、CIM_Controllerから継承されます。

MaxQuiesceTime

データ型: uint64

アクセスの種類: 読み取り専用

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

名前

データ型: string

アクセスの種類: 読み取り専用

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

OperatingStatus

データ型: uint16

アクセスの種類: 読み取り専用

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

不明 (0)

使用できません (1)

サービス (2)

開始 (3)

停止中 (4)

停止 ( 5)

中止 ( 6)

休止状態 (7)

完了 (8)

移行 ( 9)

Emigrating (10)

未移行 (11)

スナップショット処理 (12)

シャットダウン (13)

In Test (14)

移行中 (15)

In Service (16)

DMTF 予約済み (..)

ベンダー予約 済み (0x8000.. )

OperationalStatus

データ型: uint16 配列

アクセスの種類: 読み取り専用

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

OtherEnabledState

データ型: string

アクセスの種類: 読み取り専用

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

OtherIdentifyingInfo

データ型: 文字列 配列

アクセスの種類: 読み取り専用

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

PowerManagementCapabilities

データ型: uint16 配列

アクセスの種類: 読み取り専用

デバイスの電源管理機能。 このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

PowerManagementSupported

データ型: boolean

アクセスの種類: 読み取り専用

デバイスを電源管理できるかどうかを示します。 このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

PowerOnHours

データ型: uint64

アクセスの種類: 読み取り専用

最後の電源サイクル以降にこのデバイスの電源がオンになっている連続した時間数。 このプロパティは CIM_LogicalDeviceから継承されますが、使用されません。

PrimaryStatus

データ型: uint16

アクセスの種類: 読み取り専用

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

不明 (0)

OK (1)

機能低下 (2)

エラー (3)

DMTF 予約済み (..)

ベンダー予約 済み (0x8000.. )

ProtocolDescription

データ型: string

アクセスの種類: 読み取り専用

コントローラーでサポートされているプロトコルに関連する詳細情報を提供する文字列。 このプロパティは、 CIM_Controllerから継承されます。

ProtocolSupported

データ型: uint16

アクセスの種類: 読み取り専用

制御されたデバイスにアクセスするためにコントローラーによって使用されるプロトコル。 このプロパティは、 CIM_Controllerから継承されます。

値	説明
26	IEEE-488

RequestedState

データ型: uint16

アクセスの種類: 読み取り専用

要素に対して最後に要求された状態または目的の状態。 要素の実際の状態は EnabledState で表されます。 このプロパティは、最後に要求された状態と現在有効または無効になっている状態を比較するために提供されます。 このプロパティは、 CIM_EnabledLogicalElementから継承されます。

値	説明
12	適用しない

Security

データ型: uint16

アクセスの種類: 読み取り専用

コントローラーの運用セキュリティ。 このプロパティは、 CIM_SerialControllerから継承されます。

値	説明
3	なし

状態

データ型: string

アクセスの種類: 読み取り専用

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

StatusDescriptions

データ型: 文字列 配列

アクセスの種類: 読み取り専用

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

StatusInfo

データ型: uint16

アクセスの種類: 読み取り専用

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

SystemCreationClassName

データ型: string

アクセスの種類: 読み取り専用

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

Systemname

データ型: string

アクセスの種類: 読み取り専用

スコープ仮想マシンの一意識別子。 このプロパティは 、CIM_LogicalDeviceから継承されます。

TimeOfLastReset

データ型: datetime

アクセスの種類: 読み取り専用

コントローラーの電源が最後にオンになった時刻。 このプロパティは、 CIM_Controllerから継承されます。

TimeOfLastStateChange

データ型: datetime

アクセスの種類: 読み取り専用

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

TotalPowerOnHours

データ型: uint64

アクセスの種類: 読み取り専用

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

TransitioningToState

データ型: uint16

アクセスの種類: 読み取り専用

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

注釈

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

要件

こちらもご覧ください

CIM_SerialController

CIM_SerialController

シリアル デバイス クラス