CIM_Battery クラス

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

CIM_Battery クラスは、バッテリ論理デバイスの機能と管理を表します。このクラスはラップトップシステムの電池および他の内部および外的な電池に適用される。

重要

DMTF (分散管理タスクフォース) CIM (共通情報モデル) クラスは、WMI クラスが構築される親クラスです。 WMI では現在、 CIM 2.x バージョンスキーマのみがサポートされています。

次の構文は、マネージドオブジェクトフォーマット (MOF) コードを簡素化しており、継承されたすべてのプロパティを含んでいます。プロパティは、MOF の順序ではなく、アルファベット順で一覧表示されます。

構文

[Abstract, UUID("{8502C548-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_Battery : CIM_LogicalDevice
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  uint16   Availability;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   DeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  ErrorCleared;
  string   ErrorDescription;
  uint32   LastErrorCode;
  string   PNPDeviceID;
  boolean  PowerManagementSupported;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   BatteryStatus;
  uint16   Chemistry;
  uint32   DesignCapacity;
  uint64   DesignVoltage;
  uint16   EstimatedChargeRemaining;
  uint32   EstimatedRunTime;
  uint32   ExpectedLife;
  uint32   FullChargeCapacity;
  uint32   MaxRechargeTime;
  string   SmartBatteryVersion;
  uint32   TimeOnBattery;
  uint32   TimeToFullCharge;
};

メンバー

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

メソッド
プロパティ

メソッド

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

メソッド	説明
リセット	論理デバイスのリセットを要求します。 WMI によって実装されていません。
SetPowerState	論理デバイスの目的の電源状態と、デバイスをその状態にするタイミングを定義します。 WMI によって実装されていません。

プロパティ

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

可用性

データ型: uint16
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|運用状態|003.5"、"MIB。IETF|HOST-RESOURCES-MIB.hrDeviceStatus")

デバイスの可用性と状態。

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

その他 (1)

不明 (2)

実行中/完全電源 (3)

警告 (4)

In Test (5)

適用なし (6)

電源オフ (7)

Off Line (8)

オフデューティ (9)

低下 (10)

インストールされていません (11)

インストールエラー (12)

省電力 - 不明 (13)

デバイスは省電力モードであることが知られていますが、正確な状態は不明です。

省電力 - 低電力モード (14)

デバイスは省電力状態ですが、引き続き機能しており、パフォーマンスが低下する可能性があります。

省電力 - スタンバイ (15)

デバイスは機能していませんが、すぐに完全な電源に入る可能性があります。

電源サイクル (16)

省電力 - 警告 (17)

ただし、デバイスは警告状態ですが、省電力モードでもあります。

一時停止 ( 18)

デバイスが一時停止しています。

準備ができていません (19)

デバイスの準備ができていません。

未構成 (20)

デバイスが構成されていません。

休止 ( 21)

デバイスは静かです。

BatteryStatus

データ型: uint16
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|ポータブルバッテリー|002.14")

バッテリーの充電状態の説明。値 10 は CIM スキーマでは無効です。これは、デスクトップ管理インターフェイス (DMI) にバッテリがインストールされていないことを表します。この場合、オブジェクトをインスタンス化しないでください。

その他 (1)

その他。

不明 (2)

不明。

フル充電 (3)

完全に課金されます。

低 (4)

低。

重大 (5)

重大

充電 (6)

充電。

充電と高 (7)

充電と高。

充電と低 (8)

充電と低。

充電と重大 (9)

充電とクリティカル。

Undefined (10)

未定義です。

一部課金 (11)

部分的に課金されます。

Caption

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

オブジェクトの短いテキストの説明。

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

Chemistry

データ型: uint16
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|ポータブルバッテリー|002.7")

バッテリーの化学を記述する列挙。

その他 (1)

その他。

不明 (2)

不明。

鉛酸 (3)

鉛酸。

ニッケルカドミウム (4)

ニッケルカドミウム

ニッケル水素 ( 5)

ニッケル水素

リチウムイオン (6)

リチウムイオン。

亜鉛空気 (7)

亜鉛空気。

リチウムポリマー (8)

リチウムポリマー。

ConfigManagerErrorCode

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")

Win32 Configuration Managerエラーコード。

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

このデバイスは正常に動作しています。 (0)

このデバイスが正しく構成されていません。 (1)

Windows では、このデバイスのドライバーを読み込めません。 (2)

このデバイスのドライバーが破損しているか、システムがメモリやその他のリソースで不足している可能性があります。 (3)

このデバイスは正常に動作していません。そのドライバーの 1 つまたはレジストリが破損している可能性があります。 (4)

このデバイスのドライバーには、Windows で管理できないリソースが必要です。 (5)

このデバイスのブート構成が他のデバイスと競合しています。 (6)

フィルター処理できません。 (7)

デバイスのドライバーローダーがありません。 (8)

制御ファームウェアがデバイスのリソースを誤って報告しているため、このデバイスは正常に動作していません。 (9)

このデバイスを起動できません。 (10)

このデバイスは失敗しました。 (11)

このデバイスは、使用できる十分な空きリソースを見つけることができません。 (12)

Windows では、このデバイスのリソースを確認できません。 (13)

コンピューターを再起動するまで、このデバイスは正常に動作しません。 (14)

再列挙の問題が発生している可能性があるため、このデバイスは正常に動作していません。 (15)

Windows では、このデバイスが使用するすべてのリソースを識別することはできません。 (16)

このデバイスは、不明なリソースの種類を要求しています。 (17)

このデバイスのドライバーを再インストールします。 (18)

VxD ローダーの使用に失敗しました。 (19)

レジストリが破損している可能性があります。 (20)

システムエラー: このデバイスのドライバーを変更してみてください。問題が解決しない場合は、ハードウェアのドキュメントを参照してください。 Windows はこのデバイスを削除しています。 (21)

このデバイスは無効になっています。 (22)

システムエラー: このデバイスのドライバーを変更してみてください。それでも問題が解決しない場合は、ハードウェアのドキュメントを参照してください。 (23)

このデバイスが存在しない、正しく動作していない、またはすべてのドライバーがインストールされていない。 (24)

Windows は引き続きこのデバイスを設定しています。 (25)

Windows は引き続きこのデバイスを設定しています。 (26)

このデバイスには有効なログ構成がありません。 (27)

このデバイスのドライバーはインストールされていません。 (28)

デバイスのファームウェアで必要なリソースが提供されていないため、このデバイスは無効になっています。 (29)

このデバイスは、別のデバイスが使用している割り込み要求 (IRQ) リソースを使用しています。 (30)

Windows はこのデバイスに必要なドライバーを読み込むことができないため、このデバイスは正常に動作していません。 (31)

ConfigManagerUserConfig

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: スキーマ ("Win32")

TRUE の場合、デバイスはユーザー定義の構成を使用します。

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

CreationClassName

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

インスタンスの作成で使用されるクラスまたはサブクラスの名前。クラスの他のキープロパティと共に使用する場合、このプロパティを使用すると、クラスとそのサブクラスのすべてのインスタンスを一意に識別できます。

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

説明

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

オブジェクトのテキストの説明。

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

DesignCapacity

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|ポータブルバッテリー|002.8"), ユニット ("ミリワット時間")

ミリワット時のバッテリーの容量を設計しました。このプロパティがサポートされていない場合は、「0」と入力します。

DesignVoltage

データ型: uint64
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|ポータブルバッテリー|002.9"), ユニット ("ミリボルト")

ミリボルト単位でバッテリの電圧を設計しました。この属性がサポートされていない場合は、「0」と入力します。

スクリプトでの uint64 値の使用の詳細については、「 WMI でのスクリプト作成」を参照してください。

DeviceID

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

論理デバイスに一意の名前を付けるアドレスまたはその他の識別情報。

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

ErrorCleared

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

TRUE の場合、LastErrorCode プロパティで報告されたエラーはクリアされます。

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

ErrorDescription

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

LastErrorCode プロパティに記録されたエラーと実行する修正アクションに関する情報を提供する自由形式の文字列。

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

EstimatedChargeRemaining

データ型: uint16
アクセスの種類: 読み取り専用
修飾子: 単位 ("percent")

残りの完全な料金の見積もりパーセンテージ。

EstimatedRunTime

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|ポータブルバッテリー|002.15"), ユニット ("分")

ユーティリティ電源がオフの場合、現在の負荷条件下でバッテリ充電が使い果たされるまでの推定時間 (分単位) は失われ、電源が切れたままになります。または、ラップトップが電源から切断されている場合。

ExpectedLife

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: 単位 ("分")

バッテリーが完全に充電されていると仮定した場合、バッテリーの予想される寿命 (分単位)。このプロパティは、 EstimatedRunTime プロパティによって示される現在の残存寿命ではなく、バッテリの合計予想寿命を表します。

FullChargeCapacity

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|ポータブルバッテリー|002.11"), ユニット ("ミリワット時間")

バッテリーの全充電容量 (ミリワット時間)。この値を DesignCapacity プロパティと比較して、バッテリーの交換が必要なタイミングを判断します。通常、バッテリの寿命は 、FullChargeCapacity プロパティが DesignCapacity プロパティの 80% を下回る場合です。このプロパティがサポートされていない場合は、「0」と入力します。

InstallDate

データ型: datetime
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("インストール日")

オブジェクトがインストールされた日時を示します。値がない場合、オブジェクトがインストールされていないことを示すわけではありません。

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

LastErrorCode

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

論理デバイスによって報告された最後のエラーコード。

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

MaxRechargeTime

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: 単位 ("分")

バッテリーを完全に充電するための最大時間 (分単位)。このプロパティは、 TimeToFullCharge プロパティに示されている現在の残りの充電時間ではなく、完全に使い果たされたバッテリーを充電する時間を表します。

名前

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

オブジェクトが認識されるラベル。サブクラス化すると、このプロパティをキープロパティとしてオーバーライドできます。

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

PNPDeviceID

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

論理デバイスの Win32 プラグアンドプレイデバイス識別子を示します。

例: "*PNP030b"

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

PowerManagementCapabilities

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

論理デバイスの特定の電源関連機能を示します。

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

不明 (0)

電源関連の容量は不明です。

サポートされていません (1)

このデバイスでは、電源関連の容量はサポートされていません。

無効 (2)

電源関連の容量が無効になっています。

有効 (3)

電源管理機能は現在有効になっていますが、正確な機能セットが不明であるか、情報が使用できません。

自動的に入力された省電力モード (4)

デバイスは、使用状況やその他の条件に基づいて電源状態を変更できます。

電源状態設定可能 (5)

SetPowerState メソッドがサポートされています。このメソッドは親 CIM_LogicalDevice クラスで見つかり、実装できます。詳細については、「マネージドオブジェクト形式 (MOF) クラスの設計」を参照してください。

電源循環がサポートされています (6)

SetPowerState メソッドは、PowerState パラメーターを 5 ("Power Cycle") に設定して呼び出すことができます。

時間指定の電源オンがサポートされています (7)

SetPowerState メソッドは、PowerState パラメーターを 5 ("Power Cycle") に設定し、Time パラメーターを特定の日付と時刻または間隔に設定して電源オンを行って呼び出すことができます。

PowerManagementSupported

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

TRUE の場合、デバイスを電源管理できます。つまり、省電力状態になります。 FALSE の場合、PowerManagementCapabilities 配列の唯一のエントリは整数値 1 ("サポートされていません") である必要があります。

このプロパティは、電源管理機能が現在有効になっているか、有効になっているか、どの機能がサポートされているかを示しません。詳細については、「 PowerManagementCapabilities 配列」を参照してください。

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

SmartBatteryVersion

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (64)、 MappingStrings ("MIF。DMTF|ポータブルバッテリー|002.10")

このバッテリーでサポートされているスマートバッテリーデータ仕様のバージョン番号。バッテリーがこの関数をサポートしていない場合は、値を空のままにする必要があります。

状態

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

オブジェクトの現在の状態を示す文字列。運用状態と非運用状態を定義できます。操作状態には、"OK"、"低下"、"事前失敗" が含まれます。 "Pred Fail" は、要素が正しく機能しているが、エラー (SMART 対応ハードディスクドライブなど) を予測していることを示します。

非運用状態には、"エラー"、"開始中"、"停止中"、"サービス" が含まれる場合があります。 "サービス" は、ディスクのミラー、ユーザーのアクセス許可リストの再読み込み、またはその他の管理作業中に適用できます。このような作業のすべてがオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。

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

次の値があります。

OK ("OK")

エラー ("Error")

機能低下 ("Degraded")

不明 ("不明")

Pred Fail ("Pred Fail")

開始 ("開始")

停止中 ("停止中")

サービス ("Service")

ストレス ( "ストレス")

NonRecover ("NonRecover")

連絡先なし ("連絡先なし")

Lost Comm ("Lost Comm")

StatusInfo

データ型: uint16
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|運用状態|003.3")

論理デバイスの状態。このプロパティが論理デバイスに適用されない場合は、値 5 ("Not Applicable") を使用する必要があります。

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

その他 (1)

不明 (2)

有効 (3)

無効 (4)

適用なし (5)

SystemCreationClassName

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

スコープシステムの作成クラス名。

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

Systemname

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

スコープシステムの名前。

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

TimeOnBattery

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: 単位 ("秒")

コンピューター・システムの UPS が最後にバッテリー電源に切り替えた後の経過時間 (秒単位)、またはシステムまたは UPS が最後に再起動されてからの時間のいずれか少ない方。バッテリーが "オンライン" の場合、値 0 が返されます。

TimeToFullCharge

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("MIF.DMTF|ポータブルバッテリー|002.16"), ユニット ("分")

残りの時間は、分単位で、現在の充電レートで完全にバッテリーを充電し、使用する。

解説

CIM_Battery クラスは、CIM_LogicalDeviceから派生します。

WMI では、このクラスは実装されません。 CIM_Batteryから派生したクラスの詳細については、「Win32 クラス」を参照してください。

このドキュメントは、DMTF によって公開されている CIM クラスの説明から派生しています。 Microsoft は、軽微なエラーを修正したり、Microsoft SDK ドキュメントの標準に準拠したり、詳細情報を提供したりするために変更を加えた可能性があります。

必要条件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMV2
MOF	CIMWin32.mof
[DLL]	CIMWin32.dll

次の方法で共有

CIM_Battery クラス

構文

メンバー

メソッド

プロパティ

解説

必要条件

関連項目

フィードバック

その他のリソース