Share via

classe CIM_Battery

  • Articolo

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
CIMWin32.mof
DLL
CIMWin32.dll

Vedi anche

Cim_logicaldevice