Classe Win32_Battery

  • Articolo

La classe WMI Win32_Batteryrappresenta una batteria connessa al sistema del computer.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà sono elencate in ordine alfabetico, non in ordine MOF.

Sintassi

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

Membri

La classe Win32_Battery ha questi tipi di membri:

Metodi

La classe Win32_Battery dispone di questi metodi.

Metodo Descrizione
Reimposta Non implementata. Per implementare questo metodo, vedere il metodo Reset in CIM_Battery per la documentazione.
SetPowerState Non implementata. Per implementare questo metodo, vedere il metodo SetPowerState in CIM_Battery per la documentazione.

Proprietà

La classe Win32_Battery ha queste proprietà.

Disponibilità

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |Stato operativo|003.5", "MIB. IETF |HOST-RESOURCES-MIB.hrDeviceStatus")

Disponibilità e stato del dispositivo.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Altro (1)

Sconosciuto (2)

Esecuzione/alimentazione completa (3)

Esecuzione o alimentazione completa

Avviso (4)

In test (5)

Non applicabile (6)

Spegnimento (7)

Fuori linea (8)

Fuori servizio (9)

Degradato (10)

Non installato (11)

Errore di installazione (12)

Risparmio energia - Sconosciuto (13)

Il dispositivo è noto come in modalità risparmio energia, ma lo stato esatto è sconosciuto.

Risparmio energia - Modalità risparmio energia ridotta (14)

Il dispositivo si trova in uno stato di risparmio energia ma funziona ancora e può presentare prestazioni ridotte.

Risparmio energia - Standby (15)

Il dispositivo non funziona, ma può essere portato a piena potenza rapidamente.

Ciclo di alimentazione (16)

Risparmio energia - Avviso (17)

Il dispositivo è in uno stato di avviso, anche se in modalità risparmio energia.

Sospeso (18)

Il dispositivo è in pausa.

Non pronto (19)

Il dispositivo non è pronto.

Non configurato (20)

Il dispositivo non è configurato.

Quiesced (21)

Il dispositivo è silenzioso.

BatteryRechargeTime

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: DEPRECATO, MappingStrings ("HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|Ricaricare"), unità ("minuti")

Tempo necessario per caricare completamente la batteria. Questa proprietà non è supportata. BatteryRechargeTime non dispone di una proprietà sostitutiva ed è ora considerata obsoleta.

BatteryStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |Batteria portatile|002.14")

Stato della batteria. Il valore 10 (Non definito) non è valido nello schema CIM perché in DMI rappresenta che non è installata alcuna batteria. In questo caso, l'oggetto non deve essere creato un'istanza.

Questa proprietà viene ereditata da CIM_Battery.

Altro (1)

La batteria sta scaricando.

Sconosciuto (2)

Il sistema ha accesso all'ac in modo che non venga scaricata alcuna batteria. Tuttavia, la batteria non è necessariamente carica.

Completamente addebitato (3)

Bassa (4)

Critico (5)

Ricarica (6)

Ricarica e alta (7)

Ricarica e bassa (8)

Ricarica e critica (9)

Non definito (10)

Addebito parziale (11)

Caption

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64), DisplayName ("Caption")

Breve descrizione dell'oggetto di una stringa a una riga.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Chimica

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |Batteria portatile|002.7")

Enumerazione che descrive la chimica della batteria.

Questa proprietà viene ereditata da CIM_Battery.

Altro (1)

Sconosciuto (2)

Acido piombo (3)

Nickel Languageum (4)

Metal Hydride (5)

Ioni di litio (6)

Aria di zinco (7)

Polimeri di litio (8)

ConfigManagerErrorCode

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: schema ("Win32")

Codice di errore di Windows Configuration Manager.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Questo dispositivo funziona correttamente. (0)

Il dispositivo funziona correttamente.

Questo dispositivo non è configurato correttamente. (1)

Il dispositivo non è configurato correttamente.

Windows non può caricare il driver per questo dispositivo. (2)

Il driver per questo dispositivo potrebbe essere danneggiato o il sistema potrebbe essere in esecuzione insufficiente nella memoria o in altre risorse. (3)

Il driver per questo dispositivo potrebbe essere danneggiato o il sistema potrebbe essere insufficiente nella memoria o in altre risorse.

Questo dispositivo non funziona correttamente. Uno dei driver o del Registro di sistema potrebbe essere danneggiato. (4)

Il dispositivo non funziona correttamente. Uno dei driver o del Registro di sistema potrebbe essere danneggiato.

Il driver per questo dispositivo richiede una risorsa che Windows non può gestire. (5)

Il driver per il dispositivo richiede una risorsa che Windows non può gestire.

La configurazione di avvio per questo dispositivo è in conflitto con altri dispositivi. (6)

La configurazione di avvio per il dispositivo è in conflitto con altri dispositivi.

Impossibile filtrare. (7)

Il caricatore driver per il dispositivo non è presente. (8)

Driver loader per il dispositivo mancante.

Questo dispositivo non funziona correttamente perché il firmware di controllo segnala erroneamente le risorse per il dispositivo. (9)

Il dispositivo non funziona correttamente. Il firmware di controllo segnala erroneamente le risorse per il dispositivo.

Impossibile avviare il dispositivo. (10)

Impossibile avviare il dispositivo.

Il dispositivo non è riuscito. (11)

Dispositivo non riuscito.

Questo dispositivo non riesce a trovare risorse gratuite sufficienti che può usare. (12)

Il dispositivo non riesce a trovare risorse sufficienti da usare.

Windows non è in grado di verificare le risorse del dispositivo. (13)

Windows non è in grado di verificare le risorse del dispositivo.

Questo dispositivo non può funzionare correttamente fino a quando non si riavvia il computer. (14)

Il dispositivo non può funzionare correttamente finché il computer non viene riavviato.

Questo dispositivo non funziona correttamente perché è probabile che si verifichi un problema di rienumerazione. (15)

Il dispositivo non funziona correttamente a causa di un possibile problema di rienumerazione.

Windows non è in grado di identificare tutte le risorse usate dal dispositivo. (16)

Windows non è in grado di identificare tutte le risorse usate dal dispositivo.

Questo dispositivo richiede un tipo di risorsa sconosciuto. (17)

Il dispositivo richiede un tipo di risorsa sconosciuto.

Reinstallare i driver per questo dispositivo. (18)

I driver di dispositivo devono essere reinstallati.

Errore durante l'uso del caricatore VxD. (19)

Il registro potrebbe essere danneggiato. (20)

Il Registro di sistema potrebbe essere danneggiato.

Errore di sistema: provare a modificare il driver per questo dispositivo. Se non funziona, vedere la documentazione hardware. Windows rimuove questo dispositivo. (21)

Errore di sistema. Se la modifica del driver di dispositivo è inefficace, vedere la documentazione hardware. Windows rimuove il dispositivo.

Questo dispositivo è disabilitato. (22)

Il dispositivo è disabilitato.

Errore di sistema: provare a modificare il driver per questo dispositivo. In caso contrario, vedere la documentazione dell'hardware. (23)

Errore di sistema. Se la modifica del driver di dispositivo è inefficace, vedere la documentazione hardware.

Questo dispositivo non è presente, non funziona correttamente o non dispone di tutti i driver installati. (24)

Il dispositivo non è presente, non funziona correttamente o non dispone di tutti i driver installati.

Windows sta ancora configurando questo dispositivo. (25)

Windows sta ancora configurando il dispositivo.

Windows sta ancora configurando questo dispositivo. (26)

Windows sta ancora configurando il dispositivo.

Questo dispositivo non dispone di una configurazione log valida. (27)

Il dispositivo non dispone di una configurazione log valida.

I driver per questo dispositivo non sono installati. (28)

I driver di dispositivo non sono installati.

Questo dispositivo è disabilitato perché il firmware del dispositivo non ha dato le risorse necessarie. (29)

Il dispositivo è disabilitato. Il firmware del dispositivo non ha fornito le risorse necessarie.

Questo dispositivo usa una risorsa IRQ (Interrupt Request) usata da un altro dispositivo. (30)

Il dispositivo usa una risorsa IRQ usata da un altro dispositivo.

Questo dispositivo non funziona correttamente perché Windows non è in grado di caricare i driver necessari per questo dispositivo. (31)

Il dispositivo non funziona correttamente. Windows non può caricare i driver di dispositivo necessari.

ConfigManagerUserConfig

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: schema ("Win32")

Se True, il dispositivo usa una configurazione definita dall'utente.

Questa proprietà viene ereditata da CIM_LogicalDevice.

CreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: CIM_Key

Nome della prima classe concreta visualizzata nella catena di ereditarietà utilizzata nella creazione di un'istanza di . Se utilizzata con le altre proprietà chiave della classe, la proprietà consente l'identificazione univoca di tutte le istanze di questa classe e delle relative sottoclassi.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Description")

Descrizione dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

DesignCapacity

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |Batteria portatile|002.8"), unità ("milliwatt-hours")

Capacità di progettazione della batteria in milliwatt-hours. Se la proprietà non è supportata, immettere 0 (zero).

Questa proprietà viene ereditata da CIM_Battery.

DesignVoltage

Tipo di dati: uint64

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |Batteria portatile|002.9"), unità ("millivolts")

Tensione di progettazione della batteria in millivolt. Se l'attributo non è supportato, immettere 0 (zero).

Questa proprietà viene ereditata da CIM_Battery.

Per altre informazioni sull'uso di valori uint64 negli script, vedere Scripting in WMI.

Deviceid

Tipo di dati: string

Tipo di accesso: sola lettura

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

Identifica la batteria.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Esempio: "Batteria interna"

ErrorCleared

Tipo di dati: booleano

Tipo di accesso: sola lettura

Se True, l'errore segnalato nella proprietà LastErrorCode viene ora cancellato.

Questa proprietà viene ereditata da CIM_LogicalDevice.

ErrorDescription

Tipo di dati: string

Tipo di accesso: sola lettura

Stringa in formato libero che fornisce altre informazioni sull'errore registrato nella proprietà LastErrorCode e informazioni sulle azioni correttive che possono essere eseguite.

Questa proprietà viene ereditata da CIM_LogicalDevice.

EstimatedChargeRemaining

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: unità ("percent")

Stima della percentuale di addebito totale rimanente.

Questa proprietà viene ereditata da CIM_Battery.

EstimatedRunTime

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |Batteria portatile|002.15"), unità ("minuti")

Stimare in minuti l'esaurimento della carica della batteria in condizioni di carico presenti se l'alimentazione dell'utilità è spenta o persa e rimane spenta o un portatile viene disconnesso da una fonte di alimentazione.

Questa proprietà viene ereditata da CIM_Battery.

ExpectedBatteryLife

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: DEPRECATO, MappingStrings ("HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|BatteryLife"), unità ("minuti")

Quantità di tempo necessario per scaricare completamente la batteria dopo che è completamente carica. Questa proprietà non viene più utilizzata e viene considerata obsoleta.

ExpectedLife

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: unità ("minuti")

Durata prevista della batteria in minuti, presupponendo che la batteria sia completamente carica. La proprietà rappresenta la durata totale prevista della batteria, non la durata rimanente corrente, indicata dalla proprietà EstimatedRunTime .

Questa proprietà viene ereditata da CIM_Battery.

FullChargeCapacity

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |Batteria portatile|002.11"), unità ("milliwatt-hours")

Capacità di ricarica completa della batteria in milliwatt-hours. Il confronto del valore con la proprietà DesignCapacity determina quando la batteria richiede la sostituzione. La fine della durata di una batteria è in genere quando la proprietà FullChargeCapacity scende al di sotto dell'80% della proprietà DesignCapacity . Se la proprietà non è supportata, immettere 0 (zero).

Questa proprietà viene ereditata da CIM_Battery.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |ComponentID|001.5"), DisplayName ("Data di installazione")

Data e ora di installazione dell'oggetto. Questa proprietà non richiede un valore per indicare che l'oggetto è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

LastErrorCode

Tipo di dati: uint32

Tipo di accesso: sola lettura

Ultimo codice di errore segnalato dal dispositivo logico.

Questa proprietà viene ereditata da CIM_LogicalDevice.

MaxRechargeTime

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: unità ("minuti")

Tempo massimo, in minuti, per caricare completamente la batteria. La proprietà rappresenta il tempo necessario per ricaricare una batteria completamente esaurita, non il tempo di carica rimanente corrente, indicato nella proprietà TimeToFullCharge .

Questa proprietà viene ereditata da CIM_Battery.

Nome

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Name")

Definisce l'etichetta in base alla quale l'oggetto è noto. Se sottoclassata, è possibile eseguire l'override della proprietà in modo che sia una proprietà chiave.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

PNPDeviceID

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: schema ("Win32")

Identificatore del dispositivo Plug and Play di Windows del dispositivo logico.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Esempio: "*PNP030b"

PowerManagementCapabilities

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Matrice delle funzionalità specifiche correlate all'alimentazione di un dispositivo logico.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Sconosciuto (0)

Non supportato (1)

Disabilitato (2)

Abilitato (3)

Le funzionalità di risparmio energia sono attualmente abilitate, ma il set di funzionalità esatto è sconosciuto o le informazioni non sono disponibili.

Modalità risparmio energia immesse automaticamente (4)

Il dispositivo può modificare lo stato di alimentazione in base all'utilizzo o ad altri criteri.

Power State Settable (5)

Il metodo SetPowerState è supportato. Questo metodo è disponibile nella classe padre CIM_LogicalDevice e può essere implementato. Per altre informazioni, vedere Progettazione di classi MOF (Managed Object Format).

Power Cycling supportato (6)

Il metodo SetPowerState può essere richiamato con il parametro PowerState impostato su 5 (Power Cycle).

Accensione temporizzato supportata (7)

Accensione temporizzato supportata

Il metodo SetPowerState può essere richiamato con il parametro PowerState impostato su 5 (Power Cycle) e Time impostato su una data e un'ora specifiche, o intervallo, per l'accensione.

PowerManagementSupported

Tipo di dati: booleano

Tipo di accesso: sola lettura

Se True, il dispositivo può essere gestito dall'alimentazione (può essere messo in modalità di sospensione e così via). La proprietà non indica che le funzionalità di risparmio energia sono attualmente abilitate, ma solo che il dispositivo logico è in grado di gestire il risparmio energia.

Questa proprietà viene ereditata da CIM_LogicalDevice.

SmartBatteryVersion

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64), MappingStrings ("MIF. DMTF |Batteria portatile|002.10")

Numero di versione della specifica dati supportato dalla batteria. Se la batteria non supporta questa funzione, il valore deve essere lasciato vuoto.

Questa proprietà viene ereditata da CIM_Battery.

Stato

Tipo di dati: string

Tipo di accesso: sola lettura

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

Stato corrente dell'oggetto. È possibile definire vari stati operativi e non operativi. Gli stati operativi includono: "OK", "Degraded" e "Pred Fail" (un elemento, ad esempio un'unità disco rigido abilitata per SMART, potrebbe funzionare correttamente, ma prevedere un errore nel prossimo futuro). Gli stati non operativi includono: "Error", "Starting", "Stopping" e "Service". Quest'ultimo, "Servizio", può essere applicato durante il ridimensionamento mirror di un disco, il ricaricamento di un elenco di autorizzazioni utente o altre operazioni amministrative. Non tutte queste operazioni sono online, ma l'elemento gestito non è "OK" né in uno degli altri stati.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sono inclusi i valori seguenti:

OK ("OK ")

Errore ("Errore ")

Degradato ("degradato")

Sconosciuto ("Sconosciuto")

Pred Fail ("Pred Fail ")

Avvio ("Starting ")

Arresto ("arresto ")

Servizio ("Servizio")

Sottolineato ("sottolineato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto ")

Lost Comm ("Lost Comm ")

StatusInfo

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |Stato operativo|003.3")

Stato del dispositivo logico. Se questa proprietà non si applica al dispositivo logico, è necessario usare il valore 5 (Non applicabile).

Questa proprietà viene ereditata da CIM_LogicalDevice.

Altro (1)

Sconosciuto (2)

Abilitato (3)

Disabilitato (4)

Non applicabile (5)

SystemCreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: propagati ("CIM_System.CreationClassName"), CIM_Key

Valore della proprietà CreationClassName del computer di ambito.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Systemname

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: propagati ("CIM_System.Nome"), CIM_Key

Nome del sistema di definizione dell'ambito.

Questa proprietà viene ereditata da CIM_LogicalDevice.

TimeOnBattery

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: unità ("secondi")

Tempo trascorso in secondi dall'ultima volta che l'UPS del sistema del computer è passato all'alimentazione a batteria o il tempo trascorso dall'ultimo riavvio del sistema o UPS, a seconda di quale sia minore. Se la batteria è "in linea", viene restituito 0 (zero).

Questa proprietà viene ereditata da CIM_Battery.

TimeToFullCharge

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |Batteria portatile|002.16"), unità ("minuti")

Tempo rimanente per caricare completamente la batteria in minuti alla velocità di ricarica e all'utilizzo correnti.

Questa proprietà viene ereditata da CIM_Battery.

Osservazioni:

La classe Win32_Battery deriva da CIM_Battery che deriva da CIM_LogicalDevice.

Windows Server 2008 contiene i driver UPS (APC) nel sistema operativo, che consente di trattare l'UPS come alimentatore a batteria. In questo modo è possibile monitorare lo stato ups usando uno script e intraprendere azioni quando necessario.

Requisiti

Requisito valore
Client minimo supportato
 Windows Vista
Server minimo supportato
 Windows Server 2008
Spazio dei nomi
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Vedi anche

CIM_Battery

Classi hardware del sistema informatico