共用方式為

Win32_Battery 類別

  • 發行項

Win32_Battery WMI 類別代表連接到電腦系統的電池。

下列語法已經過受管理物件格式 (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|Operational State|003.5“， ”MIB.IETF|HOST-RESOURCES-MIB.hrDeviceStatus“）

裝置的可用性和狀態。

此屬性繼承自 CIM_LogicalDevice。

其他 （1）

未知 （2）

執行/完整電源 （3）

執行或完整電源

警告 （4）

測試中 （5）

不適用 （6）

電源關閉 （7）

離線 （8）

下班 （9）

降級 （10）

未安裝 （11）

安裝錯誤 （12）

省電 - 未知 （13）

已知裝置處於省電模式，但其確切狀態不明。

省電 - 低電量模式 （14）

裝置處於省電狀態，但仍正常運作，而且可能會呈現效能降低。

省電 - 待命 （15）

裝置無法正常運作，但可快速提供全電源。

電源週期 （16）

省電 - 警告 （17）

裝置處於警告狀態，不過也處於省電模式。

暫停 （18）

裝置已暫停。

未就緒 （19）

裝置尚未就緒。

未設定 （20）

未設定裝置。

靜止 （21）

裝置很安靜。

BatteryRechargeTime

數據類型： uint32

存取類型：唯讀

限定符：DEPRECATED，MappingStrings （“HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|充電率），單位（「分鐘」）

完全充電電池所需的時間。 不支援這個屬性。 BatteryRechargeTime 沒有取代屬性，現在被視為過時。

BatteryStatus

數據類型： uint16

存取類型：唯讀

限定符： MappingStrings （“MIF.DMTF|便攜式電池|002.14“）

電池的狀態。 值 10 （Undefined） 在 CIM 架構中無效，因為在 DMI 中，它表示未安裝任何電池。 在此情況下，不應該具現化物件。

此屬性繼承自 CIM_Battery。

其他 （1）

電池正在充電。

未知 （2）

系統可以存取 AC，因此沒有電池正在排放。 不過，電池不一定充電。

完全收費 （3）

低 （4）

重大 （5）

充電 （6）

充電和高 （7）

充電和低 （8）

充電與關鍵 （9）

未定義 （10）

部分收費 （11）

標題

數據類型： 字串

存取類型：唯讀

限定符： MaxLen （64）， DisplayName （“Caption”）

對象簡短描述一行字串。

此屬性繼承自 CIM_ManagedSystemElement。

化學

數據類型： 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)

此裝置的驅動程式可能已損毀，或系統可能記憶體不足或其他資源。

此裝置無法正常運作。其中一個驅動程式或登錄可能已損毀。 (4)

裝置無法正常運作。 其中一個驅動程式或登錄可能已損毀。

此裝置的驅動程式需要 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

資料類型： 字串

存取類型：唯讀

限定詞： CIM_Key

出現在實例建立時所用繼承鏈結中之第一個具體類別的名稱。 與 類別的其他索引鍵屬性搭配使用時，屬性允許唯一識別此類別及其子類別的所有實例。

此屬性繼承自 CIM_LogicalDevice 。

說明

資料類型： 字串

存取類型：唯讀

限定詞： DisplayName （「Description」）

物件的描述。

此屬性繼承自 CIM_ManagedSystemElement 。

DesignCapacity

資料類型： uint32

存取類型：唯讀

限定詞： MappingStrings （「MIF.DMTF|可擕式電池|002.8「）， 單位 （」milliwatt-hours「）

以毫秒為單位設計電池的容量。 如果不支援 屬性，請輸入 0 （零）。

此屬性繼承自 CIM_Battery 。

DesignVoltage

資料類型： uint64

存取類型：唯讀

限定詞： MappingStrings （「MIF.DMTF|可擕式電池|002.9「）， 單位 （」millivolts「）

設計以千伏數為單位的電池電壓。 如果不支援屬性，請輸入 0 （零）。

此屬性繼承自 CIM_Battery 。

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

DeviceID

資料類型： 字串

存取類型：唯讀

限定詞： 索引鍵 、 覆寫 （「DeviceId」）， MappingStrings （「WMI」）

識別電池。

此屬性繼承自 CIM_LogicalDevice 。

範例：「內部電池」

ErrorCleared

資料類型： 布林值

存取類型：唯讀

如果 為 True ，則會清除 LastErrorCode 屬性中 報告的錯誤。

此屬性繼承自 CIM_LogicalDevice 。

ErrorDescription

資料類型： 字串

存取類型：唯讀

自由格式字串，提供有關 LastErrorCode 屬性中記錄之錯誤的詳細資訊，以及可能採取之任何更正動作的相關信息。

此屬性繼承自 CIM_LogicalDevice。

EstimatedChargeRemaining

數據類型： uint16

存取類型：唯讀

限定符： 單位 （“percent”）

估計剩餘全額費用的百分比。

此屬性繼承自 CIM_Battery。

EstimatedRunTime

數據類型： uint32

存取類型：唯讀

限定符： MappingStrings （“MIF.DMTF|便攜式電池|002.15“）， 單位 （”分鐘“）

在目前負載狀況下估計電池充電耗盡的時間，如果公用程式電源關閉或中斷或保持關閉，或膝上型電腦與電源中斷連線。

此屬性繼承自 CIM_Battery。

ExpectedBatteryLife

數據類型： uint32

存取類型：唯讀

限定符：DEPRECATED，MappingStrings （“HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|BatteryLife）、單位（“分鐘”）

完全充電後完全耗盡電池所需的時間量。 這個屬性已不再使用，而且被視為已過時。

ExpectedLife

數據類型： uint32

存取類型：唯讀

限定符： 單位 （「分鐘」）

假設電池已完全充電，電池的預期存留期為分鐘數。 屬性代表電池的總預期壽命，而不是其目前的剩餘壽命，以 EstimatedRunTime 屬性表示。

此屬性繼承自 CIM_Battery。

FullChargeCapacity

數據類型： uint32

存取類型：唯讀

限定符： MappingStrings （“MIF.DMTF|便攜式電池|002.11“）， 單位 （”milliwatt-hours“）

以毫秒為單位的電池完整充電容量。 值與 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。

名稱

數據類型： 字串

存取類型：唯讀

限定符： DisplayName （“Name”）

定義已知對象的標籤。 子類別化時，屬性可以覆寫為索引鍵屬性。

此屬性繼承自 CIM_ManagedSystemElement。

PNPDeviceID

數據類型： 字串

存取類型：唯讀

限定符： 架構 （“Win32”）

Windows 隨插即用 邏輯裝置的裝置標識碼。

此屬性繼承自 CIM_LogicalDevice。

範例：“*PNP030b”

PowerManagementCapabilities

數據類型： uint16 陣列

存取類型：唯讀

邏輯裝置的特定電源相關功能陣列。

此屬性繼承自 CIM_LogicalDevice。

未知 （0）

不支援 （1）

已停用 （2）

已開啟 （3）

電源管理功能目前已啟用，但確切的功能集未知或信息無法使用。

自動 輸入的省電模式 （4）

裝置可以根據使用量或其他準則變更其電源狀態。

Power State Settable （5）

支援 SetPowerState 方法。 這個方法位於父 CIM_LogicalDevice 類別上，而且可以實作。 如需詳細資訊，請參閱 設計 Managed 物件格式 （MOF） 類別。

支援 電源迴圈 （6）

您可以叫用 SetPowerState 方法，並將 PowerState 參數設定為 5 （Power Cycle）。

支援的 計時電源 （7）

支援的計時電源

您可以叫用 SetPowerState 方法，並將 PowerState 參數設定為 5（Power Cycle），並將時間設定為特定日期和時間，或開啟電源的間隔。

PowerManagementSupported

數據類型： 布爾值

存取類型：唯讀

如果 為 True，則裝置可以受電源管理（可以進入暫停模式等等）。 屬性不會指出電源管理功能目前已啟用，只有邏輯裝置能夠進行電源管理。

此屬性繼承自 CIM_LogicalDevice。

SmartBatteryVersion

數據類型： 字串

存取類型：唯讀

限定符： MaxLen （64）， MappingStrings （“MIF.DMTF|便攜式電池|002.10“）

電池支援的數據規格版本號碼。 如果電池不支援此函式，值應該會保留空白。

此屬性繼承自 CIM_Battery。

狀態

數據類型： 字串

存取類型：唯讀

限定符： MaxLen （10）， DisplayName （“Status”）

物件的目前狀態。 您可以定義各種操作和非操作狀態。 作業狀態包括：「OK」、「已降級」和「Pred Fail」（智慧型硬碟等元素可能正常運作，但預測近期失敗）。 非操作狀態包括：“Error”、“Starting”、“Stopping” 和 “Service”。 後者「服務」可以在磁碟的鏡像重新Silvering、重載用戶權力清單或其他系統管理工作期間套用。 並非所有這類工作都在在線，但 Managed 元素既不是「確定」，也不是在其他其中一個狀態。

此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

確定 （“OK”）

錯誤 （「錯誤」

已降級 （「已降級」）

未知 （「未知」）

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

資料類型： 字串

存取類型：唯讀

限定詞： 傳播 （「 CIM_System. CreationClassName 「）， CIM_Key

範圍電腦的 CreationClassName 屬性值。

此屬性繼承自 CIM_LogicalDevice 。

SystemName

資料類型： 字串

存取類型：唯讀

限定詞： 傳播 （「 CIM_System. 名稱 CIM_Key

範圍系統的名稱。

此屬性繼承自 CIM_LogicalDevice 。

TimeOnBattery

資料類型： uint32

存取類型：唯讀

限定詞： 單位 （「秒」）

電腦系統 UPS 上次切換為電池電源，或上次重新開機系統或 UPS 的時間，以秒為單位耗用時間，無論哪一個都少。 如果電池是「線上」，則會傳回 0 （零） 。

此屬性繼承自 CIM_Battery 。

TimeToFullCharge

資料類型： uint32

存取類型：唯讀

限定詞： MappingStrings （「MIF.DMTF|可擕式電池|002.16「）， 單位 （」分鐘「）

剩餘時間，以目前的充電速率和使用量，以分鐘為單位完全充電電池。

此屬性繼承自 CIM_Battery 。

備註

Win32_Battery類別衍生自衍生自 CIM_LogicalDevice CIM_Battery。

Windows Server 2008 包含作業系統中的 （APC） UPS 驅動程式，可讓您將 UPS 視為電池供應。 這可讓您使用腳本監視 UPS 狀態，並在必要時採取動作。

需求

需求 值
最低支援的用戶端
 Windows Vista
最低支援的伺服器
 Windows Server 2008
Namespace
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

另請參閱

CIM_Battery

電腦系統硬體類別