CIM _ Battery-Klasse
Die CIM _ Battery-Klasse stellt die Funktionen und die Verwaltung des logischen Akkugeräts dar. Diese Klasse gilt für Akkus in Laptopsystemen und anderen internen und externen Akkus.
Wichtig
Die CIM-Klassen (Distributed Management Task Force) (DMTF (Distributed Management Task Force) (Common Information Model) sind die übergeordneten Klassen, auf denen WMI-Klassen erstellt werden. WMI unterstützt derzeit nur die CIM 2.x-Versionsschemas.
Die folgende Syntax wird durch MOF-Code (Managed Object Format) vereinfacht und schließt alle geerbten Eigenschaften ein. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.
Syntax
[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;
};
Member
Die CIM _ Battery-Klasse verfügt über diese Typen von Membern:
Methoden
Die CIM _ Battery-Klasse verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| Zurücksetzen | Fordert eine Zurücksetzung des logischen Geräts an. Nicht von WMI implementiert. |
| SetPowerState | Definiert den gewünschten Energiezustand für ein logisches Gerät und wann das Gerät in diesen Zustand versetzt werden soll. Nicht von WMI implementiert. |
Eigenschaften
Die CIM _ Battery-Klasse verfügt über diese Eigenschaften.
-
Verfügbarkeit
-
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | Operational State | 003.5", "MIB. IETF | HOST-RESOURCES-MIB.hrDeviceStatus")
Verfügbarkeit und Status des Geräts.
Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt.
-
-
Andere (1)
-
Unbekannt (2)
-
Running/Full Power (3) (Ausführen/Vollbetrieb (3))
-
Warnung (4)
-
In Test (5)
-
Nicht zutreffend (6)
-
Ausschalten (7)
-
Off Line (8)
-
Off-Duty (9)
-
Heruntergestuft (10)
-
Nicht installiert (11)
-
Installationsfehler (12)
-
Energiesparen – Unbekannt (13)
-
Das Gerät befindet sich bekanntermaßen im Energiesparmodus, aber sein genauer Status ist unbekannt.
-
Energiesparmodus – Energiesparmodus (14)
-
Das Gerät befindet sich im Energiesparzustand, funktioniert aber weiterhin und kann eine beeinträchtigte Leistung aufweisen.
-
Energiesparmodus – Standby (15)
-
Das Gerät funktioniert nicht, kann aber schnell voll ausgepowert werden.
-
Stromzyklus (16)
-
Energiesparen – Warnung (17)
-
Das Gerät befindet sich in einem Warnungszustand, aber auch im Energiesparmodus.
-
Angehalten (18)
-
Das Gerät wird angehalten.
-
Nicht bereit (19)
-
Das Gerät ist nicht bereit.
-
Nicht konfiguriert (20)
-
Das Gerät ist nicht konfiguriert.
-
Still (21)
-
Das Gerät ist still.
BatteryStatus
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | Portable Battery | 002.14")
Beschreibung des Akkuladestatus. Der Wert 10 ist im CIM-Schema ungültig, das darstellt, dass in der Desktop Management Interface (DMI) kein Akku installiert wird. In diesem Fall sollte das -Objekt nicht instanziiert werden.
Andere (1)
Sonstiges
Unbekannt (2)
Unbekannt
Vollständig in Rechnung gestellt (3)
Vollständig in Rechnung gestellt.
Niedrig (4)
Niedrig.
Kritisch (5)
Kritisch.
Gebühren (6)
Laden.
Aufladen und Hoch (7)
Aufladen und hoch.
Gebühren und Niedrig (8)
Aufladen und niedrig.
Gebühren und kritisch (9)
Gebühren und kritisch.
Nicht definiert (10)
Nicht definiert.
Teilweise in Rechnung gestellt (11)
Teilweise in Rechnung gestellt.
Caption
-
Datentyp: String
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (64), DisplayName ("Caption")
Eine kurze Textbeschreibung des Objekts.
Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.
Chemie
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | Portable Battery | 002.7")
Enumeration, die die Chemie des Akkus beschreibt.
Andere (1)
Sonstiges
Unbekannt (2)
Unbekannt
Lead acid (3)
Lead-Acid.
Soll Soll (4)
Dies ist der 1.
Metal-Hydride (5)
Metal-Hydride:
Lithium-Ion (6)
Lithium-Ion.
Luft (7)
Luft aus Luft.
Lithium Soll (8)
Dies ist der 19.
ConfigManagerErrorCode
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32")
Win32 Konfigurations-Manager Fehlercode.
Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt.
Dieses Gerät funktioniert ordnungsgemäß. (0)
Dieses Gerät ist nicht ordnungsgemäß konfiguriert. (1)
Windows kann den Treiber für dieses Gerät nicht laden. (2)
Der Treiber für dieses Gerät ist möglicherweise beschädigt, oder ihr System verfügt über wenig Arbeitsspeicher oder andere Ressourcen. (3)
Dieses Gerät funktioniert nicht ordnungsgemäß. Einer der Treiber oder Ihre Registrierung ist möglicherweise beschädigt. (4)
Der Treiber für dieses Gerät benötigt eine Ressource, die Windows nicht verwalten können. (5)
Die Startkonfiguration für dieses Gerät ist mit anderen Geräten in Konflikt. (6)
Kann nicht gefiltert werden. (7)
Das Treiberladeprogramm für das Gerät fehlt. (8)
Dieses Gerät funktioniert nicht ordnungsgemäß, da die steuernde Firmware die Ressourcen für das Gerät falsch meldet. (9)
Dieses Gerät kann nicht gestartet werden. (10)
Auf diesem Gerät ist ein Fehler aufgetreten. (11)
Dieses Gerät kann nicht genügend kostenlose Ressourcen finden, die es verwenden kann. (12)
Windows können die Ressourcen dieses Geräts nicht überprüfen. (13)
Dieses Gerät kann erst ordnungsgemäß funktionieren, wenn Sie den Computer neu starten. (14)
Dieses Gerät funktioniert nicht ordnungsgemäß, da es wahrscheinlich ein Problem mit der erneuten Enumeration gibt. (15)
Windows können nicht alle Ressourcen identifizieren, die dieses Gerät verwendet. (16)
Dieses Gerät fordert einen unbekannten Ressourcentyp an. (17)
Installieren Sie die Treiber für dieses Gerät neu. (18)
Fehler beim Verwenden des VxD-Laders. (19)
Ihre Registrierung ist möglicherweise beschädigt. (20)
Systemfehler: Versuchen Sie, den Treiber für dieses Gerät zu ändern. Wenn dies nicht funktioniert, finden Sie weitere Informationen in der Hardwaredokumentation. Windows entfernt dieses Gerät. (21)
Dieses Gerät ist deaktiviert. (22)
Systemfehler: Versuchen Sie, den Treiber für dieses Gerät zu ändern. Wenn dies nicht funktioniert, finden Sie weitere Informationen in der Hardwaredokumentation. (23)
Dieses Gerät ist nicht vorhanden, funktioniert nicht ordnungsgemäß oder verfügt nicht über alle installierten Treiber. (24)
Windows richtet dieses Gerät noch ein. (25)
Windows richtet dieses Gerät noch ein. (26)
Dieses Gerät verfügt nicht über eine gültige Protokollkonfiguration. (27)
Die Treiber für dieses Gerät sind nicht installiert. (28)
Dieses Gerät ist deaktiviert, da die Firmware des Geräts ihm nicht die erforderlichen Ressourcen bereitgestellt hat. (29)
Dieses Gerät verwendet eine IRQ-Ressource (Interrupt Request), die von einem anderen Gerät verwendet wird. (30)
Dieses Gerät funktioniert nicht ordnungsgemäß, da Windows die für dieses Gerät erforderlichen Treiber nicht laden können. (31)
ConfigManagerUserConfig
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32")
True gibt an, dass das Gerät eine benutzerdefinierte Konfiguration verwendet.
Diese Eigenschaft wird von CIM _ LogicalDevicegeerbt.
CreationClassName
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: _ CIM-Schlüssel
Name der Klasse oder Unterklasse, die bei der Erstellung einer Instanz verwendet wird. Bei Verwendung mit anderen Schlüsseleigenschaften der -Klasse ermöglicht diese Eigenschaft die eindeutige Identifizierung aller Instanzen der Klasse und ihrer Unterklassen.
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
Beschreibung
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Description")
Eine Textbeschreibung des Objekts.
Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.
DesignCapacity
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | Portable Battery | 002.8"), Units ("milliwatt-hours")
Entworfene Kapazität des Akkus in Millisekunden. Wenn diese Eigenschaft nicht unterstützt wird, geben Sie 0 ein.
DesignVoltage
-
Datentyp: uint64
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | Portable Battery | 002.9"), Units ("milli milli" (DMTF Portable Akku 002.9"), Einheiten ("milli milli")
Entworfene Spannung des Akkus in Millisekunden. Wenn dieses Attribut nicht unterstützt wird, geben Sie 0 ein.
Weitere Informationen zur Verwendung von uint64-Werten in Skripts finden Sie unter Skripterstellung in WMI.
Deviceid
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: _ CIM-Taste
Adresse oder andere identifizierende Informationen, um das logische Gerät eindeutig zu benennen.
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
ErrorCleared
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
True gibt an, dass der in der LastErrorCode-Eigenschaft gemeldete Fehler jetzt entfernt wird.
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
ErrorDescription
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
Freiformzeichenfolge, die Informationen zum In der LastErrorCode-Eigenschaft aufgezeichneten Fehler und durchzuführende Korrekturmaßnahmen enthält.
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
EstimatedChargeRemaining
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Einheiten ("Prozent")
Geschätzter Prozentsatz der verbleibenden vollständigen Gebühr.
EstimatedRunTime
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | Portable Battery | 002.15"), Units ("minutes")
Geschätzte Zeit in Minuten, bis der Akkustand unter den aktuellen Auslastungsbedingungen erschöpft ist, wenn die Stromversorgung des Hilfsprogramms ausgeschaltet ist, verloren geht und aus bleibt, oder wenn ein Laptop von einer Stromquelle getrennt ist.
ExpectedLife
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Einheiten ("Minuten")
Die erwartete Lebensdauer des Akkus in Minuten, vorausgesetzt, der Akku ist vollständig aufgeladen. Diese Eigenschaft stellt die erwartete Gesamtlebensdauer des Akkus und nicht seine aktuelle verbleibende Lebensdauer dar, was durch die EstimatedRunTime-Eigenschaft angegeben wird.
FullChargeCapacity
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | Portable Battery | 002.11"), Units ("milliwatt-hours")
Die vollständige Ladekapazität des Akkus in Millisekunden. Vergleichen Sie diesen Wert mit der DesignCapacity-Eigenschaft, um zu bestimmen, wann der Akku austauscht werden muss. Die Endlebensdauer eines Akkus ist in der Regel, wenn die FullChargeCapacity-Eigenschaft unter 80 Prozent der DesignCapacity-Eigenschaft fällt. Wenn diese Eigenschaft nicht unterstützt wird, geben Sie 0 ein.
InstallDate
-
Datentyp: datetime
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | ComponentID | 001.5"), DisplayName ("Installation date")
Gibt an, wann das Objekt installiert wurde. Das Fehlen eines Werts gibt nicht an, dass das Objekt nicht installiert ist.
Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.
LastErrorCode
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Letzter vom logischen Gerät gemeldeter Fehlercode.
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
MaxRechargeTime
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Einheiten ("Minuten")
Maximale Zeit in Minuten, um den Akku vollständig zu laden. Diese Eigenschaft stellt die Zeit dar, um einen vollständig erschöpften Akku aufzufüllen, nicht die aktuelle verbleibende Ladezeit, die in der TimeToFullCharge-Eigenschaft angegeben ist.
Name
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: DisplayName ("Name")
Bezeichnung, unter der das Objekt bekannt ist. Bei Unterklassen kann diese Eigenschaft überschrieben werden, um eine Schlüsseleigenschaft zu sein.
Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.
PNPDeviceID
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Schema ("Win32")
Gibt den Win32 Plug & Play-Gerätebezeichner des logischen Geräts an.
Beispiel: * "PNP030b"
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
PowerManagementCapabilities
-
Datentyp: uint16 array
-
Zugriffstyp: Schreibgeschützt
Gibt die spezifischen energiebezogenen Funktionen des logischen Geräts an.
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
Unbekannt (0)
Die energiebezogenen Kapazitäten sind unbekannt.
Nicht unterstützt (1)
Energiebezogene Kapazitäten werden für dieses Gerät nicht unterstützt.
Deaktiviert (2)
Energiebezogene Kapazitäten wurden deaktiviert.
Aktiviert (3)
Die Energieverwaltungsfeatures sind derzeit aktiviert, aber der genaue Funktionssatz ist unbekannt, oder die Informationen sind nicht verfügbar.
Automatisch eingegebene Energiesparmodi (4)
Das Gerät kann seinen Energiezustand basierend auf der Nutzung oder anderen Kriterien ändern.
Power State Settable (5)
Die SetPowerState-Methode wird unterstützt. Diese Methode befindet sich in der übergeordneten CIM _ LogicalDevice-Klasse und kann implementiert werden. Weitere Informationen finden Sie unter Entwerfen Managed Object Format -Klassen (MOF).
Power-Bike unterstützt (6)
Die SetPowerState-Methode kann aufgerufen werden, wenn der PowerState-Parameter auf 5 ("Power Cycle") festgelegt ist.
Timed Power On Supported (7)
Die SetPowerState-Methode kann aufgerufen werden, wenn der PowerState-Parameter auf 5 ("Power Cycle") und der Time-Parameter auf ein bestimmtes Datum und eine bestimmte Uhrzeit oder ein bestimmtes Intervall für das Ein-/Aus-Setzen festgelegt ist.
PowerManagementSupported
-
Datentyp: boolescher Wert
-
Zugriffstyp: Schreibgeschützt
If TRUE, the device can be power managed, that is, put into a power-save state. False gibt an, dass der ganzzahlige Wert 1 ("Nicht unterstützt") der einzige Eintrag im PowerManagementCapabilities-Array sein sollte.
Diese Eigenschaft gibt nicht an, ob energieverwaltungsfeatures derzeit aktiviert sind oder welche Features unterstützt werden, sofern aktiviert. Weitere Informationen finden Sie unter PowerManagementCapabilities-Array.
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
SmartBatteryVersion
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (64), MappingStrings ("MIF. DMTF | Portable Battery | 002.10")
Spezifikationsnummer für intelligente Akkudaten, die von diesem Akku unterstützt wird. Wenn der Akku diese Funktion nicht unterstützt, sollte der Wert leer bleiben.
Status
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MaxLen (10), DisplayName ("Status")
Eine Zeichenfolge, die den aktuellen Status des Objekts angibt. Betriebsstatus und nicht betriebsbereiter Status können definiert werden. Der Betriebsstatus kann "OK", "Heruntergestuft" und "Fehler vor dem Ausfall" enthalten. "Pred Fail" gibt an, dass ein Element ordnungsgemäß funktioniert, aber einen Fehler vorhersagt (z. B. eine SMART-fähige Festplatte).
Nicht betriebsbereite Status können "Error", "Starting", "Stopping" und "Service" sein. "Dienst" kann während der Spiegelung des Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen administrativen Aufgaben angewendet werden. Nicht alle diese Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.
Diese Eigenschaft wird von CIM _ ManagedSystemElement geerbt.
Folgende Werte sind gültig:
OK ("OK")
Fehler ("Fehler")
Heruntergestuft ("Heruntergestuft")
Unbekannt ("Unbekannt")
Pred Fail ("Pred Fail")
Wird gestartet ("Wird gestartet")
Wird beendet ("Wird beendet")
Dienst ("Dienst")
Striche ("Strich")
NonRecover ("NonRecover")
Kein Kontakt ("Kein Kontakt")
Lost Comm ("Lost Comm")
StatusInfo
-
Datentyp: uint16
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | Operational State | 003.3")
Status des logischen Geräts. Wenn diese Eigenschaft nicht für das logische Gerät gilt, sollte der Wert 5 ("Nicht zutreffend") verwendet werden.
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
Sonstige (1)
Unbekannt (2)
Aktiviert (3)
Deaktiviert (4)
Nicht zutreffend (5)
SystemCreationClassName
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Propagated ("_ CIM-System.CreationClassName"), _ CIM-Schlüssel
Der Name der Erstellungsklasse des Bereichssystems.
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
Systemname
-
Datentyp: Zeichenfolge
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Propagated ("_ CIM-System.Name"), _ CIM-Schlüssel
Der Name des Bereichssystems.
Diese Eigenschaft wird von CIM _ LogicalDevice geerbt.
TimeOnBattery
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: Einheiten ("Sekunden")
Verstrichene Zeit in Sekunden, seit die USV des Computersystems zuletzt in den Akkubetrieb umgeschaltet wurde, oder die Zeitspanne seit dem letzten Neustart des Systems oder der USV, unabhängig davon, welcher Wert geringer ist. Der Wert 0 wird zurückgegeben, wenn der Akku "online" ist.
TimeToFullCharge
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
-
Qualifizierer: MappingStrings ("MIF. DMTF | Portable Battery | 002.16"), Units ("minutes")
Verbleibende Zeit in Minuten, um den Akku vollständig mit der aktuellen Laderate zu laden und zu verwenden.
Hinweise
Die CIM _ Battery-Klasse wird von CIM _ LogicalDevice abgeleitet.
WMI implementiert diese Klasse nicht. Weitere Informationen zu Klassen, die von CIM _ Battery abgeleitet wurden, finden Sie unter Win32-Klassen.
Diese Dokumentation wird von den CIM-Klassenbeschreibungen abgeleitet, die von DMTF veröffentlicht wurden. Microsoft hat möglicherweise Änderungen vorgenommen, um kleinere Fehler zu beheben, die Dokumentationsstandards des Microsoft SDK zu erfüllen oder weitere Informationen zur Verfügung zu stellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Namespace |
Stamm \ CIMV2 |
| MOF |
|
| DLL |
|