classe CIM_Battery
La classe CIM_Battery rappresenta le funzionalità e la gestione del dispositivo logico della batteria. Questa classe si applica alle batterie nei sistemi portatili e ad altre batterie interne ed esterne.
Importante
Le classi CIM (Distributed Management Task Force) (Common Information Model) DMTF (Distributed Management Task Force) sono le classi padre su cui vengono compilate le classi WMI. WMI supporta attualmente solo gli schemi di versione CIM 2.x.
La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà sono elencate in ordine alfabetico, non nell'ordine MOF.
Sintassi
[Abstract, UUID("{8502C548-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_Battery : CIM_LogicalDevice
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
uint16 Availability;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
string DeviceID;
uint16 PowerManagementCapabilities[];
boolean ErrorCleared;
string ErrorDescription;
uint32 LastErrorCode;
string PNPDeviceID;
boolean PowerManagementSupported;
uint16 StatusInfo;
string SystemCreationClassName;
string SystemName;
uint16 BatteryStatus;
uint16 Chemistry;
uint32 DesignCapacity;
uint64 DesignVoltage;
uint16 EstimatedChargeRemaining;
uint32 EstimatedRunTime;
uint32 ExpectedLife;
uint32 FullChargeCapacity;
uint32 MaxRechargeTime;
string SmartBatteryVersion;
uint32 TimeOnBattery;
uint32 TimeToFullCharge;
};
Members
La classe CIM_Battery ha questi tipi di membri:
Metodi
La classe CIM_Battery dispone di questi metodi.
| Metodo | Descrizione |
|---|---|
| Reimpostazione | Richiede una reimpostazione del dispositivo logico. Non implementato da WMI. |
| SetPowerState | Definisce lo stato di alimentazione desiderato per un dispositivo logico e quando il dispositivo deve essere inserito in tale stato. Non implementato da WMI. |
Proprietà
La classe CIM_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)
-
Avviso (4)
-
In test (5)
-
Non applicabile (6)
-
Spegni (7)
-
Off Line (8)
-
Off Duty (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 (14)
-
Il dispositivo è in uno stato di risparmio energia, ma funziona ancora e può presentare prestazioni ridotte.
-
Risparmio energia - Standby (15)
-
Il dispositivo non funziona, ma potrebbe essere portato rapidamente a piena potenza.
-
Ciclo di alimentazione (16)
-
Risparmio energia - Avviso (17)
-
Il dispositivo è in stato di avviso, anche se in modalità risparmio energia.
-
Sospeso (18)
-
Il dispositivo è sospeso.
-
Non pronto (19)
-
Il dispositivo non è pronto.
-
Non configurato (20)
-
Il dispositivo non è configurato.
-
Inattiva (21)
-
Il dispositivo è silenzioso.
BatteryStatus
-
Tipo di dati: uint16
-
Tipo di accesso: sola lettura
-
Qualificatori: MappingStrings ("MIF. DMTF| Batteria portatile|002.14")
Descrizione dello stato di carica della batteria. Il valore 10 non è valido nello schema CIM, che non rappresenta alcuna batteria installata in DMI (Desktop Management Interface). In questo caso, l'oggetto non deve essere creato un'istanza.
Altro (1)
Altro.
Sconosciuto (2)
Sconosciuto.
Completamente addebitato (3)
Completamente addebitato.
Bassa (4)
Bassa.
Critico (5)
Critica.
Ricarica (6)
Carica.
Ricarica e alta (7)
Carica e alta.
Ricarica e bassa (8)
Ricarica e bassa.
Ricarica e critici (9)
Ricarica e critica.
Non definito (10)
Non definito.
Addebito parziale (11)
Addebito parziale.
Didascalia
-
Tipo di dati: string
-
Tipo di accesso: sola lettura
-
Qualificatori: MaxLen (64), DisplayName ("Caption")
Breve descrizione testuale dell'oggetto.
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.
Altro (1)
Altro.
Sconosciuto (2)
Sconosciuto.
Acido lead (3)
Piombo.
NickelRidium (4)
Nickel nickelum.
Nickel Metal Hydride (5)
Idride del metallo di nickel.
Litio-ion (6)
Ion di litio.
Aria di zinco (7)
Aria di zinco.
Polimeri di litio (8)
Polimeri di litio.
ConfigManagerErrorCode
-
Tipo di dati: uint32
-
Tipo di accesso: sola lettura
-
Qualificatori: Schema ("Win32")
Codice errore Win32 Configuration Manager.
Questa proprietà viene ereditata da CIM_LogicalDevice.
Questo dispositivo funziona correttamente. (0)
Questo dispositivo non è configurato correttamente. (1)
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 bassa sulla memoria o su altre risorse. (3)
Questo dispositivo non funziona correttamente. Uno dei driver o del Registro di sistema potrebbe essere danneggiato. (4)
Il driver per questo dispositivo necessita di una risorsa che Windows non può gestire. (5)
La configurazione di avvio per questo dispositivo è in conflitto con altri dispositivi. (6)
Impossibile filtrare. (7)
Il caricatore driver per il dispositivo manca. (8)
Questo dispositivo non funziona correttamente perché il firmware di controllo segnala le risorse per il dispositivo in modo errato. (9)
Impossibile avviare questo dispositivo. (10)
Questo dispositivo non è riuscito. (11)
Questo dispositivo non riesce a trovare risorse gratuite sufficienti che può usare. (12)
Windows non può verificare le risorse del dispositivo. (13)
Questo dispositivo non può funzionare correttamente finché non si riavvia il computer. (14)
Questo dispositivo non funziona correttamente perché probabilmente si verifica un problema di rinumerazione. (15)
Windows non può identificare tutte le risorse usate da questo dispositivo. (16)
Questo dispositivo richiede un tipo di risorsa sconosciuto. (17)
Reinstallare i driver per questo dispositivo. (18)
Errore usando il caricatore VxD. (19)
Il Registro di sistema potrebbe essere danneggiato. (20)
Errore di sistema: provare a modificare il driver per questo dispositivo. In caso contrario, vedere la documentazione hardware. Windows rimuove questo dispositivo. (21)
Questo dispositivo è disabilitato. (22)
Errore di sistema: provare a modificare il driver per questo dispositivo. In caso contrario, vedere la documentazione hardware. (23)
Questo dispositivo non è presente, non funziona correttamente o non ha tutti i relativi driver installati. (24)
Windows sta ancora configurando questo dispositivo. (25)
Windows sta ancora configurando questo dispositivo. (26)
Questo dispositivo non ha una configurazione di log valida. (27)
I driver per questo dispositivo non sono installati. (28)
Questo dispositivo è disabilitato perché il firmware del dispositivo non ha dato le risorse necessarie. (29)
Questo dispositivo usa una risorsa di richiesta di interruzione (IRQ) usata da un altro dispositivo. (30)
Questo dispositivo non funziona correttamente perché Windows non può caricare i driver necessari per questo dispositivo. (31)
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 classe o della sottoclasse utilizzata nella creazione di un'istanza di . Se usato con altre proprietà chiave della classe, questa proprietà consente l'identificazione univoca di tutte le istanze della 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 testuale 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à progettata della batteria in milliwatt-hours. Se questa proprietà non è supportata, immettere 0.
DesignVoltage
-
Tipo di dati: uint64
-
Tipo di accesso: sola lettura
-
Qualificatori: MappingStrings ("MIF. DMTF| Batteria portatile|002.9"), unità ("millivolts")
Tensione progettata della batteria in millivolt. Se questo attributo non è supportato, immettere 0.
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: CIM_Key
Indirizzo o altre informazioni di identificazione per assegnare un nome univoco al dispositivo logico.
Questa proprietà viene ereditata da CIM_LogicalDevice.
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 informazioni sull'errore registrato nella proprietà LastErrorCode e azioni correttive da eseguire.
Questa proprietà viene ereditata da CIM_LogicalDevice.
EstimatedChargeRemaining
-
Tipo di dati: uint16
-
Tipo di accesso: sola lettura
-
Qualificatori: unità ("percentuale")
Percentuale stimata dell'addebito completo rimanente.
EstimatedRunTime
-
Tipo di dati: uint32
-
Tipo di accesso: sola lettura
-
Qualificatori: MappingStrings ("MIF. DMTF| Batteria portatile|002.15"), unità ("minuti")
Tempo stimato, in minuti, fino a quando la carica della batteria non viene esaurita nelle condizioni di carico presenti se l'alimentazione dell'utilità è spenta, viene persa e rimane spenta o se un portatile è disconnesso da una fonte di alimentazione.
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. Questa proprietà rappresenta la durata totale prevista della batteria, non la durata rimanente corrente, indicata dalla proprietà EstimatedRunTime .
FullChargeCapacity
-
Tipo di dati: uint32
-
Tipo di accesso: sola lettura
-
Qualificatori: MappingStrings ("MIF. DMTF| Batteria portatile|002.11"), unità ("milliwatt-hours")
Capacità di carica completa della batteria in milliwatt-hours. Confrontare questo valore con la proprietà DesignCapacity per determinare quando la batteria richiede la sostituzione. La durata di una batteria è in genere quando la proprietà FullChargeCapacity scende al di sotto dell'80% della proprietà DesignCapacity . Se questa proprietà non è supportata, immettere 0.
InstallDate
-
Tipo di dati: datetime
-
Tipo di accesso: sola lettura
-
Qualificatori: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data di installazione")
Indica quando l'oggetto è stato installato. La mancanza di un valore non indica che l'oggetto non è 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. Questa proprietà rappresenta il tempo necessario per ricaricare una batteria completamente esaurita, non il tempo di ricarica rimanente corrente, indicato nella proprietà TimeToFullCharge .
Nome
-
Tipo di dati: string
-
Tipo di accesso: sola lettura
-
Qualificatori: DisplayName ("Name")
Etichetta in base alla quale l'oggetto è noto. Quando viene sottoclassata, è possibile eseguire l'override di questa proprietà come proprietà chiave.
Questa proprietà viene ereditata da CIM_ManagedSystemElement.
PNPDeviceID
-
Tipo di dati: string
-
Tipo di accesso: sola lettura
-
Qualificatori: Schema ("Win32")
Indica l'identificatore del dispositivo logico Win32 Plug and Play.
Esempio: "*PNP030b"
Questa proprietà viene ereditata da CIM_LogicalDevice.
PowerManagementCapabilities
-
Tipo di dati: matrice uint16
-
Tipo di accesso: sola lettura
Indica le funzionalità specifiche relative all'alimentazione del dispositivo logico.
Questa proprietà viene ereditata da CIM_LogicalDevice.
Sconosciuto (0)
Le capacità correlate all'alimentazione sono sconosciute.
Non supportato (1)
Le capacità correlate all'alimentazione non sono supportate per questo dispositivo.
Disabilitato (2)
Le capacità correlate all'alimentazione sono state disabilitate.
Abilitato (3)
Le funzionalità di risparmio energia sono attualmente abilitate, ma il set di funzionalità esatto è sconosciuto o le informazioni non sono disponibili.
Modalità di 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").
Alimentazione ora supportata (7)
Il metodo SetPowerState può essere richiamato con il parametro PowerState impostato su 5 ("Power Cycle") e il parametro Time impostato su una data e un intervallo specifici, o intervallo, per l'alimentazione.
PowerManagementSupported
-
Tipo di dati: booleano
-
Tipo di accesso: sola lettura
Se TRUE, il dispositivo può essere gestito, ovvero, inserire in uno stato di risparmio energia. Se FALSE, il valore intero 1 ("Non supportato") deve essere l'unica voce nella matrice PowerManagementCapabilities .
Questa proprietà non indica se le funzionalità di risparmio energia sono attualmente abilitate o, se abilitate, quali funzionalità sono supportate. Per altre informazioni, vedere la matrice PowerManagementCapabilities .
Questa proprietà viene ereditata da CIM_LogicalDevice.
SmartBatteryVersion
-
Tipo di dati: stringa
-
Tipo di accesso: sola lettura
-
Qualificatori: MaxLen (64), MappingStrings ("MIF). DMTF| Batteria portatile|002.10")
Numero di versione della specifica dei dati della batteria intelligente supportato da questa batteria. Se la batteria non supporta questa funzione, il valore deve essere lasciato vuoto.
Status
-
Tipo di dati: stringa
-
Tipo di accesso: sola lettura
-
Qualificatori: MaxLen (10), DisplayName ("Status")
Stringa che indica lo stato corrente dell'oggetto. È possibile definire lo stato operativo e non operativo. Lo stato operativo può includere "OK", "Degraded" e "Pred Fail". "Pred Fail" indica che un elemento funziona correttamente, ma prevede un errore (ad esempio, un disco rigido abilitato per SMART).
Lo stato non operativo può includere "Error", "Starting", "Arresta" e "Servizio". "Servizio" può essere applicato durante il mirror-resilvering del disco, ricaricando un elenco di autorizzazioni utente o altri lavori amministrativi. Non tutti questi lavori 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 ("Avvio ")
Arresto ("Arresto")
Servizio ("Servizio ")
Sottolineato ("stressato ")
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, il valore 5 ("Non applicabile") deve essere usato.
Questa proprietà viene ereditata da CIM_LogicalDevice.
Altro (1)
Sconosciuto (2)
Abilitato (3)
Disabilitato (4)
Non applicabile (5)
SystemCreationClassName
-
Tipo di dati: stringa
-
Tipo di accesso: sola lettura
-
Qualificatori: propagati ("CIM_System. CreationClassName"), CIM_Key
Nome della classe di creazione del sistema di ambito.
Questa proprietà viene ereditata da CIM_LogicalDevice.
Systemname
-
Tipo di dati: stringa
-
Tipo di accesso: sola lettura
-
Qualificatori: propagati ("CIM_System. Nome"), CIM_Key
Nome del sistema di 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, poiché l'ups del sistema computer è passato alla potenza della batteria o il tempo trascorso dopo l'ultimo riavvio del sistema o UPS, il che è minore. Viene restituito un valore pari a 0 se la batteria è "online".
TimeToFullCharge
-
Tipo di dati: uint32
-
Tipo di accesso: sola lettura
-
Qualificatori: MappingStrings ("MIF). DMTF| Batteria portatile|002.16"), unità ("minuti")
Tempo rimanente, in minuti, per caricare completamente la batteria al tasso di ricarica corrente e usare.
Commenti
La classe CIM_Battery deriva da CIM_LogicalDevice.
WMI non implementa questa classe. Per altre informazioni sulle classi derivate da CIM_Battery, vedere Classi Win32.
Questa documentazione deriva dalle descrizioni della classe CIM pubblicate dal DMTF. Microsoft potrebbe aver apportato modifiche agli errori secondari corretti, conformi agli standard della documentazione di Microsoft SDK o fornire altre informazioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\CIMV2 |
| MOF |
|
| DLL |
|