Partager via

classe Win32_Battery

  • Article

La classe WMI Win32_Battery représente une batterie connectée au système informatique.

La syntaxe suivante est simplifiée par rapport au code 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

[Dynamic, Provider("CIMWin32"), UUID("{8502C4B9-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Battery : CIM_Battery
{
  uint16   Availability;
  uint32   BatteryRechargeTime;
  uint16   BatteryStatus;
  string   Caption;
  uint16   Chemistry;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  uint32   DesignCapacity;
  uint64   DesignVoltage;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  uint16   EstimatedChargeRemaining;
  uint32   EstimatedRunTime;
  uint32   ExpectedBatteryLife;
  uint32   ExpectedLife;
  uint32   FullChargeCapacity;
  datetime InstallDate;
  uint32   LastErrorCode;
  uint32   MaxRechargeTime;
  string   Name;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  string   SmartBatteryVersion;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TimeOnBattery;
  uint32   TimeToFullCharge;
};

Membres

La classe Win32_Battery a les types de membres suivants :

Méthodes

La classe Win32_Battery a ces méthodes.

Méthode Description
Réinitialiser Non implémenté. Pour implémenter cette méthode, consultez la méthode Reset dans CIM_Battery pour obtenir de la documentation.
SetPowerState Non implémenté. Pour implémenter cette méthode, consultez la méthode SetPowerState dans CIM_Battery pour obtenir de la documentation.

Propriétés

La classe Win32_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)

En cours d’exécution ou plein régime

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 pourrait ê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.

BatteryRechargeTime

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : DEPRECATED, MappingStrings (« HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|RechargeRate"), Units (« minutes »)

Temps nécessaire pour charger entièrement la batterie. Cette propriété n'est pas prise en charge. BatteryRechargeTime n’a pas de propriété de remplacement et est maintenant considéré comme obsolète.

BatteryStatus

Type de données : uint16

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| Batterie portable|002.14 »)

État de la batterie. La valeur 10 (Undefined) n’est pas valide dans le schéma CIM, car dans DMI, elle représente qu’aucune batterie n’est installée. Dans ce cas, l’objet ne doit pas être instancié.

Cette propriété est héritée de CIM_Battery.

Autre (1)

La batterie se décharge.

Inconnu (2)

Le système a accès au secteur de sorte qu’aucune batterie n’est déchargée. Toutefois, la batterie ne se charge pas nécessairement.

Entièrement chargé (3)

Faible (4)

Critique (5)

Chargement (6)

Chargement et élevé (7)

Charge et faible (8)

Charge et critique (9)

Non défini (10)

Partiellement facturé (11)

Caption

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (64), DisplayName (« Caption »)

Brève description de l’objet une chaîne d’une ligne.

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.

Cette propriété est héritée de CIM_Battery.

Autre (1)

Inconnu (2)

Acide de plomb (3)

Nickel Nickel Nickel ( 4)

Hydrure métallique nickel (5)

Lithium-ion (6)

Zinc air (7)

Lithium Polymère (8)

ConfigManagerErrorCode

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : Schéma (« Win32 »)

Code d’erreur windows Configuration Manager.

Cette propriété est héritée de CIM_LogicalDevice.

Cet appareil fonctionne correctement. (0)

L’appareil fonctionne correctement.

Cet appareil n’est pas configuré correctement. (1)

L’appareil n’est pas configuré correctement.

Windows ne peut pas charger le pilote pour cet appareil. (2)

Le pilote de cet appareil est peut-être endommagé ou votre système est peut-être à court de mémoire ou d’autres ressources. (3)

Le pilote de cet appareil peut être endommagé, ou le système peut être faible en mémoire ou d’autres ressources.

Cet appareil ne fonctionne pas correctement. L’un de ses pilotes ou votre registre peut être endommagé. (4)

L’appareil ne fonctionne pas correctement. L’un de ses pilotes ou le registre peut être endommagé.

Le pilote de cet appareil a besoin d’une ressource que Windows ne peut pas gérer. (5)

Le pilote de l’appareil nécessite une ressource que Windows ne peut pas gérer.

La configuration de démarrage de cet appareil est en conflit avec d’autres appareils. (6)

La configuration de démarrage de l’appareil est en conflit avec d’autres appareils.

Impossible de filtrer. (7)

Le chargeur de pilotes pour l’appareil est manquant. (8)

Le chargeur de pilotes pour l’appareil est manquant.

Cet appareil ne fonctionne pas correctement, car le microprogramme de contrôle signale les ressources de l’appareil de manière incorrecte. (9)

L’appareil ne fonctionne pas correctement. Le microprogramme de contrôle signale de manière incorrecte les ressources de l’appareil.

Cet appareil ne peut pas démarrer. (10)

L’appareil ne peut pas démarrer.

Cet appareil a échoué. (11)

Échec de l’appareil.

Cet appareil ne trouve pas suffisamment de ressources gratuites qu’il peut utiliser. (12)

L’appareil ne trouve pas suffisamment de ressources gratuites à utiliser.

Windows ne peut pas vérifier les ressources de cet appareil. (13)

Windows ne peut pas vérifier les ressources de l’appareil.

Cet appareil ne peut pas fonctionner correctement tant que vous n’avez pas redémarré votre ordinateur. (14)

L’appareil ne peut pas fonctionner correctement tant que l’ordinateur n’est pas redémarré.

Cet appareil ne fonctionne pas correctement, car il existe probablement un problème de nouvelle énumération. (15)

L’appareil ne fonctionne pas correctement en raison d’un problème possible de nouvelle énumération.

Windows ne peut pas identifier toutes les ressources utilisées par cet appareil. (16)

Windows ne peut pas identifier toutes les ressources utilisées par l’appareil.

Cet appareil demande un type de ressource inconnu. (17)

L’appareil demande un type de ressource inconnu.

Réinstallez les pilotes pour ce périphérique. (18)

Les pilotes de périphérique doivent être réinstallés.

Échec de l’utilisation du chargeur VxD. (19)

Votre registre est peut-être endommagé. (20)

Le Registre est peut-être endommagé.

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)

Défaillance du système. Si la modification du pilote de périphérique est inefficace, consultez la documentation matérielle. Windows supprime l’appareil.

Cet appareil est désactivé. (22)

L’appareil est désactivé.

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. (23)

Défaillance du système. Si la modification du pilote de périphérique est inefficace, consultez la documentation matérielle.

Cet appareil n’est pas présent, ne fonctionne pas correctement ou n’a pas tous ses pilotes installés. (24)

L’appareil n’est pas présent, ne fonctionne pas correctement ou n’a pas tous ses pilotes installés.

Windows est toujours en cours de configuration de cet appareil. (25)

Windows configure toujours l’appareil.

Windows est toujours en cours de configuration de cet appareil. (26)

Windows configure toujours l’appareil.

Cet appareil n’a pas de configuration de journal valide. (27)

L’appareil n’a pas de configuration de journal valide.

Les pilotes de ce périphérique ne sont pas installés. (28)

Les pilotes de périphérique ne sont pas installés.

Cet appareil est désactivé, car le microprogramme de l’appareil ne lui a pas donné les ressources nécessaires. (29)

L’appareil est désactivé. Le microprogramme de l’appareil n’a pas fourni les ressources requises.

Cet appareil utilise une ressource de demande d’interruption (IRQ) qu’un autre appareil utilise. (30)

L’appareil utilise une ressource IRQ qu’un autre appareil utilise.

Cet appareil ne fonctionne pas correctement, car Windows ne peut pas charger les pilotes requis pour cet appareil. (31)

L’appareil ne fonctionne pas correctement. Windows ne peut pas charger les pilotes de périphérique requis.

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 première classe concrète qui apparaît dans la chaîne d’héritage utilisée lors de la création d’un instance. Lorsqu’elle est utilisée avec les autres propriétés de clé de la classe, la propriété permet à toutes les instances de cette classe et à 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 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é de conception de la batterie en milliwatt-heures. Si la propriété n’est pas prise en charge, entrez 0 (zéro).

Cette propriété est héritée de CIM_Battery.

DesignVoltage

Type de données : uint64

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| Batterie portable|002.9 »), Unités (« millivolts »)

Conception de la tension de la batterie en millivolts. Si l’attribut n’est pas pris en charge, entrez 0 (zéro).

Cette propriété est héritée de CIM_Battery.

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 : Key, Override (« DeviceId »), MappingStrings (« WMI »)

Identifie la batterie.

Cette propriété est héritée de CIM_LogicalDevice.

Exemple : « Batterie interne »

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 plus d’informations sur l’erreur enregistrée dans la propriété LastErrorCode et des informations sur les actions correctives qui peuvent être effectuées.

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 »)

Estimation du pourcentage de charge totale restante.

Cette propriété est héritée de CIM_Battery.

EstimatedRunTime

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| Batterie portable|002.15 »), Unités (« minutes »)

Estimez en quelques minutes le temps nécessaire à l’épuisement de la charge de la batterie dans les conditions de charge actuelles si l’alimentation de l’utilitaire est éteinte ou perdue et reste éteinte, ou si un ordinateur portable est déconnecté d’une source d’alimentation.

Cette propriété est héritée de CIM_Battery.

ExpectedBatteryLife

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : DEPRECATED, MappingStrings (« HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|BatteryLife"), Units (« minutes »)

Temps nécessaire pour vider complètement la batterie une fois qu’elle est complètement chargée. Cette propriété n’est plus utilisée et est considérée comme obsolète.

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. La 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 .

Cette propriété est héritée de CIM_Battery.

FullChargeCapacity

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| Batterie portable|002.11 »), Unités (« milliwatt-heures »)

Pleine capacité de charge de la batterie en milliwatt-heures. La comparaison de la valeur à la propriété DesignCapacity détermine 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 la propriété n’est pas prise en charge, entrez 0 (zéro).

Cette propriété est héritée de CIM_Battery.

InstallDate

Type de données : datetime

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« MIF. DMTF| ComponentID|001.5 »), DisplayName (« Date d’installation »)

Date et heure d’installation de l’objet. Cette propriété n’a pas besoin d’une valeur pour indiquer que l’objet est 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. La 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 .

Cette propriété est héritée de CIM_Battery.

Nom

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : DisplayName (« Name »)

Définit l’étiquette par laquelle l’objet est connu. En cas de sous-classe, la 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 »)

Windows Plug-and-Play identificateur d’appareil de l’appareil logique.

Cette propriété est héritée de CIM_LogicalDevice.

Exemple : « *PNP030b »

PowerManagementCapabilities

Type de données : uint16 array

Type d'accès : Lecture seule

Tableau des fonctionnalités spécifiques liées à l’alimentation d’un appareil logique.

Cette propriété est héritée de CIM_LogicalDevice.

Inconnu (0)

Non pris en charge (1)

Désactivé (2)

Activé (3)

Les fonctionnalités de gestion de l’alimentation sont actuellement activées, mais l’ensemble de fonctionnalités exact 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 parente CIM_LogicalDevice et peut être implémentée. Pour plus d’informations, consultez Conception de classes MOF (Managed Object Format).

Prise en charge du cycle d’alimentation (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)

Power-On chronoté pris en charge

La méthode SetPowerState peut être appelée avec le paramètre PowerState défini sur 5 (Cycle d’alimentation) et 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 (peut être mis en mode interruption, etc.). La propriété n’indique pas que les fonctionnalités de gestion de l’alimentation sont actuellement activées, mais seulement que l’appareil logique est capable de gérer l’alimentation.

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 pris en charge par la batterie. Si la batterie ne prend pas en charge cette fonction, la valeur doit être laissée vide.

Cette propriété est héritée de CIM_Battery.

État

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MaxLen (10), DisplayName (« Status »)

Status actuelle de l’objet. Différents états opérationnels et non opérationnels peuvent être définis. Les états opérationnels sont les suivants : « OK », « Détérioré » et « Échec antérieur » (un élément, tel qu’un disque dur smart, peut fonctionner correctement, mais prédire une défaillance dans un avenir proche). Les états non opératoires sont les suivants : « Erreur », « Démarrage », « Arrêt » et « Service ». Ce dernier, « Service », peut s’appliquer pendant miroir redimensionnement d’un disque, le rechargement d’une liste d’autorisations utilisateur ou tout autre travail administratif. 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égradé (« Dégradé »)

Inconnu (« Inconnu »)

Échec du prédé (« Échec anticipé »)

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

Valeur de la propriété CreationClassName de l’ordinateur 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 vers l’alimentation de la batterie, ou l’heure depuis le dernier redémarrage du système ou de l’UPS, selon la valeur la moins élevée. Si la batterie est « en ligne », 0 (zéro) est retourné.

Cette propriété est héritée de CIM_Battery.

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 pour charger entièrement la batterie en minutes au taux de charge actuel et à l’utilisation.

Cette propriété est héritée de CIM_Battery.

Notes

La classe Win32_Battery est dérivée de CIM_Battery qui dérive de CIM_LogicalDevice.

Windows Server 2008 contient les pilotes UPS (APC) dans le système d’exploitation, ce qui vous permet de traiter l’UPS comme une alimentation de batterie. Cela vous permet de surveiller les status UPS à l’aide d’un script et d’effectuer des actions si nécessaire.

Exemples

Les exemples de requêtes de code PowerShellToggle-Wireless.ps1Win32_Battery pour déterminer s’il faut activer ou non le sans fil afin d’économiser de l’énergie.

L’exemple List UPS Information Perl Répertorie les informations sur les sources d’alimentation noninterruptibles attachées à un ordinateur.

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

Voir aussi

CIM_Battery

Classes matérielles du système informatique