Bagikan melalui

kelas Win32_Battery

  • Artikel

Kelas WMI Win32_Batterymewakili baterai yang terhubung ke sistem komputer.

Sintaks berikut disederhanakan dari kode Managed Object Format (MOF) dan menyertakan semua properti yang diwariskan. Properti tercantum dalam urutan alfabet, bukan urutan MOF.

Sintaks

[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;
};

Anggota

Kelas Win32_Battery memiliki jenis anggota ini:

Metode

Kelas Win32_Battery memiliki metode ini.

Metode Deskripsi
Atur ulang Tidak diterapkan. Untuk menerapkan metode ini, lihat metode Reset di CIM_Battery untuk dokumentasi.
SetPowerState Tidak diterapkan. Untuk menerapkan metode ini, lihat metode SetPowerState di CIM_Battery untuk dokumentasi.

Properti

Kelas Win32_Battery memiliki properti ini.

Ketersediaan

Jenis data: uint16

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF|Status Operasional|003.5", "MIB. IETF|HOST-RESOURCES-MIB.hrDeviceStatus")

Ketersediaan dan status perangkat.

Properti ini diwariskan dari CIM_LogicalDevice.

Lainnya (1)

Tidak diketahui (2)

Daya Berjalan/Penuh (3)

Daya Berjalan atau Penuh

Peringatan (4)

Dalam Pengujian (5)

Tidak Berlaku (6)

Matikan Daya (7)

Off Line (8)

Off Duty (9)

Terdegradasi (10)

Tidak Terinstal (11)

Kesalahan Penginstalan (12)

Power Save - Tidak diketahui (13)

Perangkat ini diketahui berada dalam mode hemat daya, tetapi status pastinya tidak diketahui.

Power Save - Mode Daya Rendah (14)

Perangkat dalam status hemat daya tetapi masih berfungsi, dan dapat menunjukkan performa yang terdegradasi.

Power Save - Siaga (15)

Perangkat tidak berfungsi, tetapi dapat dibawa ke daya penuh dengan cepat.

Siklus Daya (16)

Power Save - Peringatan (17)

Perangkat dalam status peringatan, meskipun juga dalam mode hemat daya.

Dijeda (18)

Perangkat dijeda.

Belum Siap (19)

Perangkat belum siap.

Tidak Dikonfigurasi (20)

Perangkat tidak dikonfigurasi.

Diam (21)

Perangkat diam.

BatteryRechargeTime

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: TIDAK DIGUNAKAN LAGI, MappingStrings ("HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|Isi Ulang"), Unit ("menit")

Waktu yang diperlukan untuk mengisi daya baterai sepenuhnya. Properti ini tidak didukung. BatteryRechargeTime tidak memiliki properti pengganti, dan sekarang dianggap usang.

BatteryStatus

Jenis data: uint16

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF|Baterai Portabel|002.14")

Status baterai. Nilai 10 (Tidak terdefinisi) tidak valid dalam skema CIM karena di DMI mewakili bahwa tidak ada baterai yang diinstal. Dalam hal ini, objek tidak boleh diinstansiasi.

Properti ini diwariskan dari CIM_Battery.

Lainnya (1)

Baterai sedang dibuang.

Tidak diketahui (2)

Sistem memiliki akses ke AC sehingga tidak ada baterai yang dibuang. Namun, baterai belum tentu mengisi daya.

Terisi Penuh (3)

Rendah (4)

Kritis (5)

Pengisian Daya (6)

Pengisian Daya dan Tinggi (7)

Pengisian Daya dan Rendah (8)

Pengisian Daya dan Kritis (9)

Tidak ditentukan (10)

Dikenakan Biaya Sebagian (11)

Caption

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: MaxLen (64), DisplayName ("Keterangan")

Deskripsi singkat objek string satu baris.

Properti ini diwariskan dari CIM_ManagedSystemElement.

Kimia

Jenis data: uint16

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF|Baterai Portabel|002.7")

Enumerasi yang menggambarkan kimia baterai.

Properti ini diwariskan dari CIM_Battery.

Lainnya (1)

Tidak diketahui (2)

Asam Timbal (3)

Kadmium Nikel (4)

Nikel Logam Hydride (5)

Litium-ion (6)

Udara seng (7)

Polimer Litium (8)

ConfigManagerErrorCode

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: Skema ("Win32")

Kode galat Windows Configuration Manager.

Properti ini diwariskan dari CIM_LogicalDevice.

Perangkat ini bekerja dengan baik. (0)

Perangkat berfungsi dengan baik.

Perangkat ini tidak dikonfigurasi dengan benar. (1)

Perangkat tidak dikonfigurasi dengan benar.

Windows tidak dapat memuat pengandar untuk perangkat ini. (2)

Pengandar untuk perangkat ini mungkin rusak, atau sistem Anda mungkin kehabisan memori atau sumber daya lainnya. (3)

Pengandar untuk perangkat ini mungkin rusak, atau sistem mungkin kehabisan memori atau sumber daya lainnya.

Perangkat ini tidak berfungsi dengan baik. Salah satu driver atau registri Anda mungkin rusak. (4)

Perangkat tidak berfungsi dengan baik. Salah satu driver atau registrinya mungkin rusak.

Pengandar untuk perangkat ini memerlukan sumber daya yang tak bisa dikelola Windows. (5)

Driver untuk perangkat memerlukan sumber daya yang tidak dapat dikelola Windows.

Konfigurasi boot untuk perangkat ini berkonflik dengan perangkat lain. (6)

Konfigurasi boot untuk perangkat berkonflik dengan perangkat lain.

Tidak dapat memfilter. (7)

Pemuat driver untuk perangkat hilang. (8)

Pemuat driver untuk perangkat hilang.

Perangkat ini tidak berfungsi dengan baik karena firmware pengontrol salah melaporkan sumber daya untuk perangkat. (9)

Perangkat tidak berfungsi dengan baik. Firmware pengontrol salah melaporkan sumber daya untuk perangkat.

Perangkat ini tidak dapat dimulai. (10)

Perangkat tidak dapat dimulai.

Perangkat ini gagal. (11)

Perangkat gagal.

Perangkat ini tidak dapat menemukan cukup sumber daya gratis yang dapat digunakannya. (12)

Perangkat tidak dapat menemukan cukup sumber daya gratis untuk digunakan.

Windows tidak dapat memverifikasi sumber daya perangkat ini. (13)

Windows tidak dapat memverifikasi sumber daya perangkat.

Perangkat ini tidak dapat bekerja dengan benar sampai Anda memulai ulang komputer Anda. (14)

Perangkat tidak dapat bekerja dengan benar sampai komputer dimulai ulang.

Perangkat ini tidak berfungsi dengan baik karena mungkin ada masalah enumerasi ulang. (15)

Perangkat tidak berfungsi dengan baik karena kemungkinan masalah enumerasi ulang.

Windows tidak dapat mengidentifikasi semua sumber daya yang digunakan perangkat ini. (16)

Windows tidak dapat mengidentifikasi semua sumber daya yang digunakan perangkat.

Perangkat ini meminta tipe sumber daya yang tidak diketahui. (17)

Perangkat meminta jenis sumber daya yang tidak diketahui.

Instal ulang pengandar untuk perangkat ini. (18)

Pengandar perangkat harus diinstal ulang.

Kegagalan menggunakan pemuat VxD. (19)

Registri Anda mungkin rusak. (20)

Registri mungkin rusak.

Kegagalan sistem: Coba ubah driver untuk perangkat ini. Jika tidak berhasil, lihat dokumentasi perangkat keras Anda. Windows sedang menghapus perangkat ini. (21)

Kegagalan sistem. Jika mengubah driver perangkat tidak efektif, lihat dokumentasi perangkat keras. Windows sedang menghapus perangkat.

Perangkat ini dinon-fungsikan. (22)

Perangkat dinonaktifkan.

Kegagalan sistem: Coba ubah driver untuk perangkat ini. Jika tidak berhasil, lihat dokumentasi perangkat keras Anda. (23)

Kegagalan sistem. Jika mengubah driver perangkat tidak efektif, lihat dokumentasi perangkat keras.

Perangkat ini tidak ada, tidak berfungsi dengan baik, atau tidak menginstal semua pengandarnya. (24)

Perangkat tidak ada, tidak berfungsi dengan baik, atau tidak menginstal semua pengandarnya.

Windows masih menyetel perangkat ini. (25)

Windows masih menyetel perangkat.

Windows masih menyetel perangkat ini. (26)

Windows masih menyetel perangkat.

Perangkat ini tidak memiliki konfigurasi log yang valid. (27)

Perangkat tidak memiliki konfigurasi log yang valid.

Pengandar untuk perangkat ini tidak terinstal. (28)

Pengandar perangkat tidak terinstal.

Perangkat ini dinonaktifkan karena firmware perangkat tidak memberikan sumber daya yang diperlukan. (29)

Perangkat dinonaktifkan. Firmware perangkat tidak menyediakan sumber daya yang diperlukan.

Perangkat ini menggunakan sumber daya Interrupt Request (IRQ) yang digunakan perangkat lain. (30)

Perangkat menggunakan sumber daya IRQ yang digunakan perangkat lain.

Perangkat ini tidak berfungsi dengan baik karena Windows tidak dapat memuat pengandar yang diperlukan untuk perangkat ini. (31)

Perangkat tidak berfungsi dengan baik. Windows tidak dapat memuat pengandar perangkat yang diperlukan.

ConfigManagerUserConfig

Jenis data: boolean

Jenis akses: Baca-saja

Kualifikasi: Skema ("Win32")

Jika True, perangkat menggunakan konfigurasi yang ditentukan pengguna.

Properti ini diwariskan dari CIM_LogicalDevice.

CreationClassName

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: CIM_Key

Nama kelas konkret pertama yang muncul dalam rantai warisan yang digunakan dalam pembuatan instans. Saat digunakan dengan properti kunci kelas lainnya, properti memungkinkan semua instans kelas ini dan subkelasnya diidentifikasi secara unik.

Properti ini diwariskan dari CIM_LogicalDevice.

Keterangan

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: DisplayName ("Description")

Deskripsi objek.

Properti ini diwariskan dari CIM_ManagedSystemElement.

DesignCapacity

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF|Baterai Portabel|002,8"), Unit ("jam miliwatt")

Kapasitas desain baterai dalam jam miliwatt. Jika properti tidak didukung, masukkan 0 (nol).

Properti ini diwariskan dari CIM_Battery.

DesignVoltage

Jenis data: uint64

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF|Baterai Portabel|002,9"), Unit ("milivolt")

Mendesain tegangan baterai dalam milivolt. Jika atribut tidak didukung, masukkan 0 (nol).

Properti ini diwariskan dari CIM_Battery.

Untuk informasi selengkapnya tentang menggunakan nilai uint64 dalam skrip, lihat Pembuatan Skrip di WMI.

DeviceID

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: Key, Override ("DeviceId"), MappingStrings ("WMI")

Mengidentifikasi baterai.

Properti ini diwariskan dari CIM_LogicalDevice.

Contoh: "Baterai Internal"

ErrorCleared

Jenis data: boolean

Jenis akses: Baca-saja

Jika True, kesalahan yang dilaporkan di properti LastErrorCode sekarang dihapus.

Properti ini diwariskan dari CIM_LogicalDevice.

ErrorDescription

Jenis data: string

Jenis akses: Baca-saja

String bentuk bebas yang menyediakan informasi lebih lanjut tentang kesalahan yang dicatat di properti LastErrorCode , dan informasi tentang tindakan korektif apa pun yang mungkin diambil.

Properti ini diwariskan dari CIM_LogicalDevice.

EstimasiChargeRemaining

Jenis data: uint16

Jenis akses: Baca-saja

Kualifikasi: Unit ("persen")

Perkiraan persentase sisa biaya penuh.

Properti ini diwariskan dari CIM_Battery.

EstimatedRunTime

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF|Baterai Portabel|002.15"), Unit ("menit")

Perkirakan dalam hitungan menit waktu untuk pengisian daya baterai habis di bawah kondisi beban saat ini jika daya utilitas mati, atau hilang dan tetap mati, atau laptop terputus dari sumber daya.

Properti ini diwariskan dari CIM_Battery.

ExpectedBatteryLife

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: TIDAK DIGUNAKAN LAGI, MappingStrings ("HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|BatteryLife"), Unit ("menit")

Jumlah waktu yang diperlukan untuk benar-benar menguras baterai setelah terisi penuh. Properti ini tidak lagi digunakan dan dianggap usang.

ExpectedLife

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: Unit ("menit")

Masa pakai baterai yang diharapkan dalam hitung menit, dengan asumsi baterai terisi penuh. Properti mewakili total masa pakai baterai yang diharapkan, bukan sisa masa pakainya saat ini, yang ditunjukkan oleh properti EstimatedRunTime .

Properti ini diwariskan dari CIM_Battery.

FullChargeCapacity

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF|Baterai Portabel|002.11"), Unit ("milliwatt-hours")

Kapasitas daya penuh baterai dalam jam miliwatt. Perbandingan nilai dengan properti DesignCapacity menentukan kapan baterai memerlukan penggantian. Akhir masa pakai baterai biasanya terjadi ketika properti FullChargeCapacity berada di bawah 80% properti DesignCapacity . Jika properti tidak didukung, masukkan 0 (nol).

Properti ini diwariskan dari CIM_Battery.

InstallDate

Jenis data: tanggalwaktu

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF|ComponentID|001.5"), DisplayName ("Tanggal Penginstalan")

Tanggal dan waktu objek diinstal. Properti ini tidak memerlukan nilai untuk menunjukkan bahwa objek diinstal.

Properti ini diwariskan dari CIM_ManagedSystemElement.

LastErrorCode

Jenis data: uint32

Jenis akses: Baca-saja

Kode kesalahan terakhir yang dilaporkan oleh perangkat logis.

Properti ini diwariskan dari CIM_LogicalDevice.

MaxRechargeTime

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: Unit ("menit")

Waktu maksimum, dalam menit, untuk mengisi daya baterai sepenuhnya. Properti menunjukkan waktu untuk mengisi ulang baterai yang sepenuhnya habis, bukan waktu pengisian daya saat ini, yang ditunjukkan dalam properti TimeToFullCharge .

Properti ini diwariskan dari CIM_Battery.

Nama

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: DisplayName ("Nama")

Menentukan label tempat objek diketahui. Ketika disubkelas, properti dapat diganti menjadi properti kunci.

Properti ini diwariskan dari CIM_ManagedSystemElement.

PNPDeviceID

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: Skema ("Win32")

Pengidentifikasi perangkat Windows Plug and Play dari perangkat logis.

Properti ini diwariskan dari CIM_LogicalDevice.

Contoh: "*PNP030b"

PowerManagementCapabilities

Jenis data: array uint16

Jenis akses: Baca-saja

Array kemampuan terkait daya tertentu dari perangkat logis.

Properti ini diwariskan dari CIM_LogicalDevice.

Tidak diketahui (0)

Tidak Didukung (1)

Dinonaktifkan (2)

Diaktifkan (3)

Fitur manajemen daya saat ini diaktifkan tetapi set fitur yang tepat tidak diketahui atau informasi tidak tersedia.

Mode Hemat Daya Dimasukkan Secara Otomatis (4)

Perangkat dapat mengubah status dayanya berdasarkan penggunaan atau kriteria lainnya.

Power State Settable (5)

Metode SetPowerState didukung. Metode ini ditemukan pada kelas CIM_LogicalDevice induk dan dapat diimplementasikan. Untuk informasi selengkapnya, lihat Mendesain Kelas Format Objek Terkelola (MOF).

Power Cycling Didukung (6)

Metode SetPowerState dapat dipanggil dengan parameter PowerState yang diatur ke 5 (Power Cycle).

Daya Berwakti Aktif Didukung (7)

Power-On Berwakti Didukung

Metode SetPowerState dapat dipanggil dengan parameter PowerState yang diatur ke 5 (Power Cycle) dan Time diatur ke tanggal dan waktu tertentu, atau interval, untuk power-on.

PowerManagementSupported

Jenis data: boolean

Jenis akses: Baca-saja

Jika True, perangkat dapat dikelola daya (dapat dimasukkan ke dalam mode ditangguhkan, dan sebagainya). Properti tidak menunjukkan bahwa fitur manajemen daya saat ini diaktifkan, hanya perangkat logis yang mampu melakukan manajemen daya.

Properti ini diwariskan dari CIM_LogicalDevice.

SmartBatteryVersion

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: MaxLen (64), MappingStrings ("MIF. DMTF|Baterai Portabel|002.10")

Nomor versi Spesifikasi Data yang didukung oleh baterai. Jika baterai tidak mendukung fungsi ini, nilai harus dibiarkan kosong.

Properti ini diwariskan dari CIM_Battery.

Keadaan

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: MaxLen (10), DisplayName ("Status")

Status objek saat ini. Berbagai status operasional dan nonoperasional dapat ditentukan. Status operasional meliputi: "OK", "Degraded", dan "Pred Fail" (elemen, seperti hard disk drive berkemampuan SMART, mungkin berfungsi dengan baik tetapi memprediksi kegagalan dalam waktu dekat). Status nonoperasional meliputi: "Kesalahan", "Mulai", "Berhenti", dan "Layanan". Yang terakhir, "Layanan", dapat berlaku selama resilvering cermin disk, memuat ulang daftar izin pengguna, atau pekerjaan administratif lainnya. Tidak semua pekerjaan tersebut online, namun elemen terkelola tidak "OK" atau di salah satu status lainnya.

Properti ini diwariskan dari CIM_ManagedSystemElement.

Nilai mencakup yang berikut:

OK ("OK")

Kesalahan ("Kesalahan")

Terdegradasi ("Terdegradasi")

Tidak diketahui ("Tidak Diketahui")

Pred Fail ("Pred Fail")

Memulai ("Memulai")

Menghentikan ("Berhenti")

Layanan ("Layanan")

Stres ("Stres")

NonRecover ("NonRecover")

Tidak Ada Kontak ("Tidak Ada Kontak")

Comm Hilang ("Hilang Comm")

StatusInfo

Jenis data: uint16

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF|Status Operasional|003.3")

Status perangkat logis. Jika properti ini tidak berlaku untuk perangkat logis, nilai 5 (Tidak Berlaku) harus digunakan.

Properti ini diwariskan dari CIM_LogicalDevice.

Lainnya (1)

Tidak diketahui (2)

Diaktifkan (3)

Dinonaktifkan (4)

Tidak Berlaku (5)

SystemCreationClassName

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: Disebarluaskan ("CIM_System.CreationClassName"), CIM_Key

Nilai properti CreationClassName komputer cakupan.

Properti ini diwariskan dari CIM_LogicalDevice.

SystemName

Jenis data: string

Jenis akses: Baca-saja

Kualifikasi: Disebarluaskan ("CIM_System.Nama"), CIM_Key

Nama sistem cakupan.

Properti ini diwariskan dari CIM_LogicalDevice.

TimeOnBattery

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: Unit ("detik")

Waktu yang berlalu dalam detik sejak UPS sistem komputer terakhir beralih ke daya baterai, atau waktu sejak sistem atau UPS terakhir dimulai ulang, mana yang kurang. Jika baterai "on line", 0 (nol) dikembalikan.

Properti ini diwariskan dari CIM_Battery.

TimeToFullCharge

Jenis data: uint32

Jenis akses: Baca-saja

Kualifikasi: MappingStrings ("MIF. DMTF|Baterai Portabel|002.16"), Unit ("menit")

Sisa waktu untuk mengisi daya baterai sepenuhnya dalam hitung menit pada laju pengisian daya dan penggunaan saat ini.

Properti ini diwariskan dari CIM_Battery.

Keterangan

Kelas Win32_Battery berasal dari CIM_Battery yang berasal dari CIM_LogicalDevice.

Windows Server 2008 berisi driver UPS (APC) di OS, yang memungkinkan Anda memperlakukan UPS sebagai pasokan baterai. Ini memungkinkan Anda untuk memantau status UPS menggunakan skrip dan mengambil tindakan bila perlu.

Persyaratan

Persyaratan Value
Klien minimum yang didukung
 Windows Vista
Server minimum yang didukung
 Windows Server 2008
Ruang nama
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Baca juga

CIM_Battery

Kelas Perangkat Keras Sistem Komputer