Win32_PortableBattery クラス

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

Win32_PortableBatteryWMI クラスには、ノートブックコンピューターのバッテリーなど、ポータブルバッテリーに関連するプロパティが含まれています。

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

構文

[Dynamic, Provider("CIMWin32"), UUID("{FAF76B9E-798C-11D2-AAD1-006008C78BC7}"), AMENDMENT]
class Win32_PortableBattery : CIM_Battery
{
  uint16   Availability;
  uint16   BatteryStatus;
  uint16   CapacityMultiplier;
  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;
  string   Location;
  string   ManufactureDate;
  string   Manufacturer;
  uint16   MaxBatteryError;
  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_PortableBattery クラスには、次の種類のメンバーがあります。

メソッド
プロパティ

メソッド

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

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

プロパティ

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

可用性

データ型: 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 (Undefined) は、共通情報モデル (CIM) スキーマでは無効です。これは、デスクトップ管理インターフェイス (DMI) ではバッテリーがインストールされていないことを示しているためです。この場合、このオブジェクトをインスタンス化しないでください。

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

その他 (1)

不明 (2)

フル充電 (3)

Low (4)

重大 (5)

充電 (6)

充電と高 (7)

充電と低 (8)

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

Undefined (10)

一部課金 (11)

CapacityMultiplier

データ型: uint16
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("SMBIOS|Type 22|設計容量乗数")

Smart Battery Data Specification (SBDS) 実装でミリワット時の値がオーバーフローしないようにするための DesignCapacity 値の乗算係数。

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

Win32 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
アクセスの種類: 読み取り専用

サポートされていません。

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

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から継承されます。

場所

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("SMBIOS|タイプ 22|場所")

バッテリーの物理的な位置。このプロパティは、コンピューターの製造元によって入力されます。

例: "背面、左側"

ManufactureDate

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("SMBIOS|タイプ 22|製造日")

バッテリーが製造された日付。

Manufacturer

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("SMBIOS|タイプ 22|製造元")

バッテリーの製造元。

MaxBatteryError

データ型: uint16
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("SMBIOS|タイプ 22|バッテリーデータの最大エラー数"、単位数 ("パーセント")

バッテリに残っている最大推定エネルギー量と、バッテリーによって報告される現在の量の差。

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)

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

Power State Settable (5)

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

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

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

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

サポートされている時間Power-On

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

PowerManagementSupported

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

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

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

SmartBatteryVersion

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

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

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

状態

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

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

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

次の値があります。

OK ("OK")

エラー ("Error")

機能低下 ("Degraded")

不明 ("不明")

Pred Fail ("Pred Fail")

開始中 ("Starting")

停止中 ("停止中")

サービス ("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 が最後に再起動されてからの経過時間のいずれか少ない方。バッテリーがオンラインの場合は、0 (ゼロ) が返されます。

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

TimeToFullCharge

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

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

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

注釈

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

要件

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

こちらもご覧ください

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

次の方法で共有

Win32_PortableBattery クラス

構文

メンバー

メソッド

プロパティ

注釈

要件

こちらもご覧ください

フィードバック

その他のリソース