Win32_Battery クラス

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

WIN32_BATTERYWMI クラスは、コンピューターシステムに接続されているバッテリを表します。

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

構文

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

メンバー

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

メソッド
プロパティ

メソッド

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

メソッド	説明
リセット	実装されていません。このメソッドを実装するには、CIM_BatteryのReset メソッドに関するドキュメントを参照してください。
SetPowerState	実装されていません。このメソッドを実装するには、CIM_BatteryのSetPowerState メソッドに関するドキュメントを参照してください。

プロパティ

Win32_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)

デバイスは静かです。

BatteryRechargeTime

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: DEPRECATED、 MappingStrings ("HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|RechargeRate")、 Units ("minutes")

バッテリーを完全に充電するのに必要な時間。このプロパティはサポートされていません。 BatteryRechargeTime には置換プロパティがないため、現在は廃止されたと見なされます。

BatteryStatus

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

バッテリーの状態。値 10 (Undefined) は、DMI ではバッテリがインストールされていないことを表しているため、CIM スキーマでは無効です。この場合、オブジェクトをインスタンス化しないでください。

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

その他 (1)

バッテリーが放電しています。

不明 (2)

システムはACにアクセスできるため、バッテリが放電されません。ただし、バッテリは必ずしも充電されるとは限りません。

フル充電 (3)

Low (4)

重大 (5)

充電 (6)

充電と高 (7)

充電と低 (8)

充電とクリティカル (9)

Undefined (10)

一部課金 (11)

Caption

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

オブジェクトの 1 行文字列の簡単な説明。

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

Chemistry

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

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

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

その他 (1)

不明 (2)

鉛酸 (3)

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

ニッケル水素 ( 5)

リチウムイオン (6)

亜鉛空気 (7)

リチウムポリマー (8)

ConfigManagerErrorCode

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

Windows Configuration Managerエラーコード。

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

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

デバイスが正常に動作しています。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

デバイスが正しく動作していません。制御ファームウェアが、デバイスのリソースを誤って報告しています。

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

デバイスを起動できません。

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

デバイスに障害が発生しました。

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

デバイスで使用できる十分な空きリソースが見つかりません。

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

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

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

コンピューターが再起動されるまで、デバイスは正常に動作しません。

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

再列挙の問題が発生したため、デバイスが正常に動作していません。

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

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

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

デバイスが不明なリソースの種類を要求しています。

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

デバイスドライバーを再インストールする必要があります。

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

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

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

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

システム障害。デバイスドライバーを変更しても効果がない場合は、ハードウェアのドキュメントを参照してください。 Windows はデバイスを削除しています。

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

デバイスが無効になっています。

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

システム障害。デバイスドライバーを変更しても効果がない場合は、ハードウェアのドキュメントを参照してください。

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

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

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

Windows は引き続きデバイスを設定しています。

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

Windows は引き続きデバイスを設定しています。

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

デバイスに有効なログ構成がありません。

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

デバイスドライバーがインストールされていません。

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

デバイスが無効になっています。デバイスファームウェアが必要なリソースを提供しませんでした。

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

デバイスは、別のデバイスが使用している IRQ リソースを使用しています。

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

デバイスが正しく動作していません。 Windows では、必要なデバイスドライバーを読み込めません。

ConfigManagerUserConfig

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

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

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

CreationClassName

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

インスタンスの作成で使用される継承チェーンに表示される最初の具象クラスの名前。クラスの他のキープロパティと共に使用する場合、プロパティを使用すると、このクラスとそのサブクラスのすべてのインスタンスを一意に識別できます。

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

説明

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

オブジェクトの説明。

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

DesignCapacity

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

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

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

DesignVoltage

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

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

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

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

DeviceID

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

バッテリーを識別します。

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

例: "内部バッテリー"

ErrorCleared

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

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

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

ErrorDescription

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

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

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

EstimatedChargeRemaining

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

残存料金の割合の見積もり。

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

EstimatedRunTime

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

ユーティリティ電源がオフになっている場合、または電源が切れているか、ノート PC が電源から切断されている場合、現在の負荷条件下でバッテリ充電が枯渇する時間を分単位で見積もります。

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

ExpectedBatteryLife

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: 非推奨、 MappingStrings ("HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|BatteryLife")、単位 ("分")

完全に充電された後にバッテリーを完全に消耗するのにかかる時間。このプロパティは使用されなくなり、廃止されたと見なされます。

ExpectedLife

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

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

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

FullChargeCapacity

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

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

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

InstallDate

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

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

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

LastErrorCode

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

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

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

MaxRechargeTime

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

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

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

Name

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

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

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

PNPDeviceID

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

Windows プラグアンドプレイ論理デバイスのデバイス識別子。

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

例: "*PNP030b"

PowerManagementCapabilities

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

論理デバイスの特定の電源関連機能の配列。

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

不明 (0)

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

無効 (2)

有効 (3)

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

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

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

電源状態設定可能 (5)

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

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

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

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

Timed Power-On Supported

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

PowerManagementSupported

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

True の場合、デバイスは電源管理 (中断モードなど) にできます。プロパティは、電源管理機能が現在有効になっていることを示すものではありません。論理デバイスが電源管理が可能な場合のみです。

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

SmartBatteryVersion

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

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

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

状態

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

オブジェクトの現在の状態。さまざまな操作状態と非操作状態を定義できます。運用状態には、"OK"、"低下"、"事前失敗" (SMART 対応ハードディスクドライブなどの要素が正常に機能している可能性がありますが、近い将来に障害が予測される可能性があります) が含まれます。非運用状態には、"Error"、"Starting"、"Stopping"、および "Service" が含まれます。後者の "サービス" は、ディスクのミラー再チェックイン、ユーザーアクセス許可リストの再読み込み、またはその他の管理作業中に適用される可能性があります。このような作業のすべてがオンラインであるわけではありませんが、マネージド要素は "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 (該当なし) を使用する必要があります。

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

その他 (1)

不明 (2)

有効 (3)

無効 (4)

適用なし (5)

SystemCreationClassName

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

スコープコンピューターの CreationClassName プロパティの値。

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

Systemname

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

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

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

TimeOnBattery

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

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

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

TimeToFullCharge

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

現在の充電レートと使用量でバッテリーを完全に数分で充電するための残りの時間。

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

注釈

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

Windows Server 2008 には OS に (APC) UPS ドライバーが含まれています。これにより、UPS をバッテリ電源として扱うことができます。これにより、スクリプトを使用して UPS の状態を監視し、必要に応じてアクションを実行できます。

例

Toggle-Wireless.ps1 PowerShell コードサンプルでは、電力を節約するためにワイヤレスを切り替えるかどうかを判断するためにWin32_Batteryクエリを実行します。

「UPS 情報の一覧表示 Perl サンプル」では、コンピューターに接続されている無停電電源装置に関する情報を一覧表示します。

要件

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

こちらもご覧ください

CIM_Battery
コンピューターシステムハードウェアクラス

次の方法で共有

Win32_Battery クラス

構文

メンバー

メソッド

プロパティ

注釈

例

要件

こちらもご覧ください

フィードバック

その他のリソース