classe Win32_Battery
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 |
|
| DLL |
|