CIM_Battery classe
La classe CIM_Battery représente les fonctionnalités et la gestion du périphérique logique de batterie. Cette classe s’applique aux batteries des ordinateurs portables et à d’autres batteries internes et externes.
Important
Les classes CIM (Common Information Model) DMTF (Distributed Management Task Force) sont les classes parentes sur lesquelles les classes WMI sont créées. WMI prend actuellement uniquement en charge les schémas de version CIM 2.x.
La syntaxe suivante est simplifiée à partir de code au format MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.
Syntaxe
[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;
};
Membres
La classe CIM_Battery a les types de membres suivants :
Méthodes
La classe CIM_Battery a ces méthodes.
Méthode | Description |
---|---|
Réinitialiser | Demande une réinitialisation de l’appareil logique. Non implémenté par WMI. |
SetPowerState | Définit l’état d’alimentation souhaité pour un appareil logique et le moment où l’appareil doit être placé dans cet état. Non implémenté par WMI. |
Propriétés
La classe CIM_Battery possède ces propriétés.
-
Disponibilité
-
-
Type de données : uint16
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| État opérationnel|003.5 », « MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus »)
Disponibilité et status de l’appareil.
Cette propriété est héritée de CIM_LogicalDevice.
-
-
Autre (1)
-
Inconnu (2)
-
En cours d’exécution/pleine puissance (3)
-
Avertissement (4)
-
Dans le test (5)
-
Non applicable (6)
-
Mise hors tension (7)
-
Hors ligne (8)
-
Hors service (9)
-
Dégradé ( 10)
-
Non installé (11)
-
Erreur d’installation (12)
-
Power Save - Inconnu (13)
-
L’appareil est connu pour être en mode d’économie d’énergie, mais son status exact est inconnu.
-
Économie d’énergie - Mode Faible consommation (14)
-
L’appareil est dans un état d’économie d’énergie, mais il fonctionne toujours et peut présenter des performances dégradées.
-
Économie d’énergie - Veille (15)
-
L’appareil ne fonctionne pas, mais peut être rapidement mis à pleine puissance.
-
Cycle d’alimentation (16)
-
Power Save - Avertissement (17)
-
L’appareil est dans un état d’avertissement, mais également en mode économie d’énergie.
-
Suspendu (18)
-
L’appareil est suspendu.
-
Non prêt (19)
-
Le périphérique n’est pas prêt.
-
Non configuré (20)
-
L’appareil n’est pas configuré.
-
Quiesced (21)
-
L’appareil est silencieux.
BatteryStatus
-
Type de données : uint16
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| Batterie portable|002.14 »)
Description du status de charge de la batterie. La valeur 10 n’est pas valide dans le schéma CIM, qui représente l’absence de batterie installée dans Desktop Management Interface (DMI). Dans ce cas, l’objet ne doit pas être instancié.
Autre (1)
Autre.
Inconnu (2)
Inconnu.
Entièrement chargé (3)
Entièrement chargé.
Faible (4)
Faible.
Critique (5)
Critique.
Chargement (6)
Charge.
Chargement et élevé (7)
Charge et haute.
Charge et faible (8)
Charge et faible.
Charge et critique (9)
Charge et critique.
Non défini (10)
Non défini.
Partiellement facturé (11)
Partiellement facturé.
Caption
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (64), DisplayName (« Caption »)
Brève description textuelle de l’objet.
Cette propriété est héritée de CIM_ManagedSystemElement.
Chimie
-
Type de données : uint16
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| Batterie portable|002.7 »)
Énumération qui décrit la chimie de la batterie.
Autre (1)
Autre.
Inconnu (2)
Inconnu.
Acide plomb (3)
Acide de plomb.
Nickel Cadmium (4)
Nickel-cadmium.
Nickel Metal Hydride (5)
Hydrure métallique nickel.
Lithium-ion (6)
Lithium ion.
Zinc air (7)
Air de zinc.
Lithium Polymère (8)
Lithium polymère.
ConfigManagerErrorCode
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : Schéma (« Win32 »)
Win32 Configuration Manager code d’erreur.
Cette propriété est héritée de CIM_LogicalDevice.
Cet appareil fonctionne correctement. (0)
Cet appareil n’est pas configuré correctement. (1)
Windows ne peut pas charger le pilote pour cet appareil. (2)
Le pilote de cet appareil peut être endommagé ou votre système peut manquer de mémoire ou d’autres ressources. (3)
Cet appareil ne fonctionne pas correctement. L’un de ses pilotes ou votre registre peut être endommagé. (4)
Le pilote de cet appareil a besoin d’une ressource que Windows ne peut pas gérer. (5)
La configuration de démarrage de cet appareil est en conflit avec d’autres appareils. (6)
Impossible de filtrer. (7)
Le chargeur de pilote pour l’appareil est manquant. (8)
Cet appareil ne fonctionne pas correctement, car le microprogramme de contrôle signale les ressources de l’appareil de manière incorrecte. (9)
Cet appareil ne peut pas démarrer. (10)
Cet appareil a échoué. (11)
Cet appareil ne peut pas trouver suffisamment de ressources libres qu’il peut utiliser. (12)
Windows ne peut pas vérifier les ressources de cet appareil. (13)
Cet appareil ne peut pas fonctionner correctement tant que vous ne redémarrez pas votre ordinateur. (14)
Cet appareil ne fonctionne pas correctement, car il existe probablement un problème de réinsentération. (15)
Windows ne peut pas identifier toutes les ressources utilisées par cet appareil. (16)
Cet appareil demande un type de ressource inconnu. (17)
Réinstallez les pilotes de cet appareil. (18)
Échec à l’aide du chargeur VxD. (19)
Votre registre est peut-être endommagé. (20)
Défaillance du système : essayez de modifier le pilote pour cet appareil. Si cela ne fonctionne pas, consultez la documentation de votre matériel. Windows supprime cet appareil. (21)
Cet appareil est désactivé. (22)
Défaillance du système : essayez de modifier le pilote pour cet appareil. Si cela ne fonctionne pas, consultez votre documentation matérielle. (23)
Cet appareil n’est pas présent, ne fonctionne pas correctement ou n’a pas tous ses pilotes installés. (24)
Windows configure toujours cet appareil. (25)
Windows configure toujours cet appareil. (26)
Cet appareil n’a pas de configuration de journal valide. (27)
Les pilotes de cet appareil ne sont pas installés. (28)
Cet appareil est désactivé, car le microprogramme de l’appareil ne lui a pas donné les ressources nécessaires. (29)
Cet appareil utilise une ressource de demande d’interruption (IRQ) qu’un autre appareil utilise. (30)
Cet appareil ne fonctionne pas correctement, car Windows ne peut pas charger les pilotes requis pour cet appareil. (31)
ConfigManagerUserConfig
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : Schéma (« Win32 »)
Si la valeur est TRUE, l’appareil utilise une configuration définie par l’utilisateur.
Cette propriété est héritée de CIM_LogicalDevice.
CreationClassName
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : CIM_Key
Nom de la classe ou de la sous-classe utilisée dans la création d’un instance. Lorsqu’elle est utilisée avec d’autres propriétés clés de la classe, cette propriété permet à toutes les instances de la classe et de ses sous-classes d’être identifiées de manière unique.
Cette propriété est héritée de CIM_LogicalDevice.
Description
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : DisplayName (« Description »)
Description textuelle de l’objet.
Cette propriété est héritée de CIM_ManagedSystemElement.
DesignCapacity
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| Batterie portable|002.8 »), Unités (« milliwatt-heures »)
Capacité conçue de la batterie en milliwatt-heures. Si cette propriété n’est pas prise en charge, entrez 0.
DesignVoltage
-
Type de données : uint64
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| Batterie portable|002.9 »), Unités (« millivolts »)
Tension conçue de la batterie en millivolts. Si cet attribut n’est pas pris en charge, entrez 0.
Pour plus d’informations sur l’utilisation de valeurs uint64 dans des scripts, voir Scripts dans WMI.
DeviceID
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : CIM_Key
Adresse ou autres informations d’identification permettant de nommer de manière unique l’appareil logique.
Cette propriété est héritée de CIM_LogicalDevice.
ErrorCleared
-
Type de données : booléen
-
Type d'accès : Lecture seule
Si la valeur est TRUE, l’erreur signalée dans la propriété LastErrorCode est maintenant effacée.
Cette propriété est héritée de CIM_LogicalDevice.
ErrorDescription
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
Chaîne de forme libre qui fournit des informations sur l’erreur enregistrée dans la propriété LastErrorCode et les actions correctives à effectuer.
Cette propriété est héritée de CIM_LogicalDevice.
EstimatedChargeRemaining
-
Type de données : uint16
-
Type d'accès : Lecture seule
-
Qualificateurs : Unités (« pourcentage »)
Pourcentage estimé de la charge totale restante.
EstimatedRunTime
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| Batterie portable|002.15 »), Unités (« minutes »)
Temps estimé, en minutes, jusqu’à ce que la charge de la batterie soit épuisée dans les conditions de charge actuelles si l’alimentation du service public est éteinte, est perdue et reste éteinte, ou si un ordinateur portable est déconnecté d’une source d’alimentation.
ExpectedLife
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : unités (« minutes »)
Durée de vie attendue de la batterie, en minutes, en supposant que la batterie est complètement chargée. Cette propriété représente la durée de vie totale attendue de la batterie, et non sa durée de vie restante actuelle, qui est indiquée par la propriété EstimatedRunTime .
FullChargeCapacity
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| Batterie portable|002.11 »), Unités (« milliwatt-heures »)
Capacité de charge totale de la batterie en milliwatt-heures. Comparez cette valeur à la propriété DesignCapacity pour déterminer quand la batterie doit être remplacée. La fin de vie d’une batterie se produit généralement lorsque la propriété FullChargeCapacity tombe en dessous de 80 % de la propriété DesignCapacity . Si cette propriété n’est pas prise en charge, entrez 0.
InstallDate
-
Type de données : datetime
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)
Indique quand l’objet a été installé. L’absence d’une valeur n’indique pas que l’objet n’est pas installé.
Cette propriété est héritée de CIM_ManagedSystemElement.
LastErrorCode
-
Type de données : uint32
-
Type d'accès : Lecture seule
Dernier code d’erreur signalé par l’appareil logique.
Cette propriété est héritée de CIM_LogicalDevice.
MaxRechargeTime
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : unités (« minutes »)
Temps maximal, en minutes, pour charger entièrement la batterie. Cette propriété représente le temps de recharge d’une batterie complètement épuisée, et non le temps de charge restant actuel, qui est indiqué dans la propriété TimeToFullCharge .
Nom
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : DisplayName (« Name »)
Étiquette par laquelle l’objet est connu. En cas de sous-classe, cette propriété peut être remplacée pour être une propriété de clé.
Cette propriété est héritée de CIM_ManagedSystemElement.
PNPDeviceID
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : Schéma (« Win32 »)
Indique l’identificateur d’appareil Win32 Plug-and-Play de l’appareil logique.
Exemple : « *PNP030b »
Cette propriété est héritée de CIM_LogicalDevice.
PowerManagementCapabilities
-
Type de données : uint16 array
-
Type d'accès : Lecture seule
Indique les fonctionnalités spécifiques liées à l’alimentation de l’appareil logique.
Cette propriété est héritée de CIM_LogicalDevice.
Inconnu (0)
Les capacités liées à l’alimentation sont inconnues.
Non pris en charge (1)
Les capacités liées à l’alimentation ne sont pas prises en charge pour cet appareil.
Désactivé (2)
Les capacités liées à l’alimentation ont été désactivées.
Activé (3)
Les fonctionnalités de gestion de l’alimentation sont actuellement activées, mais l’ensemble exact des fonctionnalités est inconnu ou les informations ne sont pas disponibles.
Modes d’économie d’énergie entrés automatiquement (4)
L’appareil peut modifier son état d’alimentation en fonction de l’utilisation ou d’autres critères.
Power State Settable (5)
La méthode SetPowerState est prise en charge. Cette méthode se trouve dans la classe CIM_LogicalDevice parent et peut être implémentée. Pour plus d’informations, consultez Conception de classes MOF (Managed Object Format).
Power Cycling pris en charge (6)
La méthode SetPowerState peut être appelée avec le paramètre PowerState défini sur 5 (« Cycle d’alimentation »).
Prise en charge de l’alimentation chrono timed (7)
La méthode SetPowerState peut être appelée avec le paramètre PowerState défini sur 5 (« Cycle d’alimentation ») et le paramètre Time défini sur une date et une heure spécifiques, ou intervalle, pour la mise sous tension.
PowerManagementSupported
-
Type de données : booléen
-
Type d'accès : Lecture seule
Si la valeur est TRUE, l’appareil peut être géré par l’alimentation, c’est-à-dire placé dans un état d’économie d’énergie. Si la valeur est FALSE, la valeur entière 1 (« Non pris en charge ») doit être la seule entrée dans le tableau PowerManagementCapabilities .
Cette propriété n’indique pas si les fonctionnalités de gestion de l’alimentation sont actuellement activées ou, si elles sont activées, quelles fonctionnalités sont prises en charge. Pour plus d’informations, consultez le tableau PowerManagementCapabilities .
Cette propriété est héritée de CIM_LogicalDevice.
SmartBatteryVersion
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (64), MappingStrings (« MIF. DMTF| Batterie portable|002.10 »)
Numéro de version de la spécification des données de la batterie intelligente qui est prise en charge par cette batterie. Si la batterie ne prend pas en charge cette fonction, la valeur doit être laissée vide.
État
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (10), DisplayName (« Status »)
Chaîne qui indique la status actuelle de l’objet. Les status opérationnelles et non opérationnelles peuvent être définies. Les status opérationnelles peuvent inclure « OK », « Détérioré » et « Échec anticipé ». « Échec anticipé » indique qu’un élément fonctionne correctement, mais qu’il prédit une défaillance (par exemple, un lecteur de disque dur compatible SMART).
Les status non opérationnelles peuvent inclure « Erreur », « Démarrage », « Arrêt » et « Service ». Le « service » peut s’appliquer pendant la miroir disque, le rechargement d’une liste d’autorisations utilisateur ou d’autres tâches administratives. Tous ces travaux ne sont pas en ligne, mais l’élément managé n’est ni « OK » ni dans l’un des autres états.
Cette propriété est héritée de CIM_ManagedSystemElement.
Les valeurs sont notamment les suivantes :
OK (« OK »)
Erreur (« Erreur »)
Détérioré (« Détérioré »)
Inconnu (« Inconnu »)
Échec de la préversion (« Échec prédé »)
Démarrage (« Démarrage »)
Arrêt (« Arrêt »)
Service (« Service »)
Stressé (« Stressé »)
NonRecover (« NonRecover »)
Aucun contact (« Aucun contact »)
Lost Comm (« Lost Comm »)
StatusInfo
-
Type de données : uint16
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| État opérationnel|003.3 »)
État de l’appareil logique. Si cette propriété ne s’applique pas à l’appareil logique, la valeur 5 (« Non applicable ») doit être utilisée.
Cette propriété est héritée de CIM_LogicalDevice.
Autre (1)
Inconnu (2)
Activé (3)
Désactivé (4)
Non applicable (5)
SystemCreationClassName
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : propagé (« CIM_System. CreationClassName »), CIM_Key
Nom de la classe de création du système d’étendue.
Cette propriété est héritée de CIM_LogicalDevice.
SystemName
-
Type de données : Chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : propagé (« CIM_System. Nom « ), CIM_Key
Nom du système d’étendue.
Cette propriété est héritée de CIM_LogicalDevice.
TimeOnBattery
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : unités (« secondes »)
Temps écoulé, en secondes, depuis le dernier basculement de l’onduleurs du système informatique sur batterie, ou la durée depuis le dernier redémarrage du système ou de l’onduleurs, selon la valeur la moins élevée. La valeur 0 est retournée si la batterie est « en ligne ».
TimeToFullCharge
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« MIF. DMTF| Batterie portable|002.16 »), Unités (« minutes »)
Temps restant, en minutes, pour charger complètement la batterie au taux de charge actuel et utiliser.
Notes
La classe CIM_Battery est dérivée de CIM_LogicalDevice.
WMI n’implémente pas cette classe. Pour plus d’informations sur les classes dérivées de CIM_Battery, consultez Classes Win32.
Cette documentation est dérivée des descriptions de classes CIM publiées par le DMTF. Microsoft a peut-être apporté des modifications pour corriger des erreurs mineures, se conformer aux normes de documentation du SDK Microsoft ou fournir plus d’informations.
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows Vista |
Serveur minimal pris en charge |
Windows Server 2008 |
Espace de noms |
Racine\CIMV2 |
MOF |
|
DLL |
|