Classe Win32_Battery
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 |
|
DLL |
|