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

Siehe auch

CIM _ LogicalDevice