classe Win32_PortableBattery

La classe WMI Win32_PortableBattery contient les propriétés liées à une batterie portable, comme une batterie d’ordinateur portable.

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 et les méthodes sont dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

[Dynamic, Provider("CIMWin32"), UUID("{FAF76B9E-798C-11D2-AAD1-006008C78BC7}"), AMENDMENT]
class Win32_PortableBattery : CIM_Battery
{
  uint16   Availability;
  uint16   BatteryStatus;
  uint16   CapacityMultiplier;
  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;
  string   Location;
  string   ManufactureDate;
  string   Manufacturer;
  uint16   MaxBatteryError;
  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_PortableBattery a les types de membres suivants :

• Méthodes
• Propriétés

Méthodes

La classe Win32_PortableBattery 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.
SetPowerState	Non implémenté. Pour implémenter cette méthode, consultez la méthode SetPowerState dans CIM_Battery.

 

Propriétés

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

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 (Undefined) n’est pas valide dans le schéma CIM (Common Information Model), car dans Desktop Management Interface (DMI), elle indique qu’aucune batterie n’est installée. Dans ce cas, cet objet ne doit pas être instancié.

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

Autre (1)

Inconnu (2)

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)

CapacityMultiplier

Type de données : uint16

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« SMBIOS| Type 22| Multiplicateur de capacité de conception « )

Facteur de multiplication de la valeur DesignCapacity pour s’assurer que la valeur de milliwatt heure ne déborde pas pour les implémentations SBDS (Smart Battery Data Specification).

Caption

Type de données : chaîne

Type d'accès : Lecture seule

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

Brève description de l’objet: 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 »)

Chimie de la batterie.

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

Autre (1)

Inconnu (2)

Acide plomb (3)

Nickel Cadmium (4)

Nickel Metal Hydride (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 »)

Win32 Configuration Manager code d’erreur.

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 peut être endommagé ou votre système peut manquer 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 pilote pour l’appareil est manquant. (8)

Le chargeur de pilote 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 incorrectement 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 peut pas trouver suffisamment de ressources libres 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 ne redémarrez pas 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 réinsentération. (15)

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

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 de cet appareil. (18)

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

Échec à l’aide du chargeur VxD. (19)

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

Le Registre 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 n’est pas efficace, 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 votre documentation matérielle. (23)

Défaillance du système. Si la modification du pilote de périphérique n’est pas efficace, 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 configure toujours cet appareil. (25)

Windows configure toujours l’appareil.

Windows configure toujours 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 cet appareil 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 ne fournissait pas 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 dans la création d’un instance. Lorsqu’elle est utilisée avec les autres propriétés clés de la classe, la propriété permet à toutes les instances de cette 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 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 cette 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 cet 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 »)

Identificateur de 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 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

Plus d’informations sur l’erreur enregistrée dans LastErrorCode et sur les actions correctives qui peuvent être prises.

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 frais restants.

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 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 désactivée, ou est 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

Non pris en charge.

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

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 entièrement 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 .

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 cette valeur avec 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 cette 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.

Lieu

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« SMBIOS| Type 22| Emplacement »)

Emplacement physique de la batterie. Cette propriété est remplie par le fabricant de l’ordinateur.

Exemple : « À l’arrière, à gauche »

ManufactureDate

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« SMBIOS| Type 22| Date de fabrication »)

Date de fabrication de la batterie.

Fabricant

Type de données : chaîne

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« SMBIOS| Type 22| Fabricant »)

Fabricant de la batterie.

MaxBatteryError

Type de données : uint16

Type d'accès : Lecture seule

Qualificateurs : MappingStrings (« SMBIOS| Type 22| Erreur maximale dans les données de batterie »), unités (« pourcentage »)

Différence entre la quantité d’énergie estimée la plus élevée restante dans la batterie et la quantité actuelle signalée par la batterie.

MaxRechargeTime

Type de données : uint32

Type d'accès : Lecture seule

Qualificateurs : unités (« minutes »)

Temps maximal, en minutes, pour charger complètement 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 .

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

É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 smart battery data specification pris en charge par cette 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 en minutes pour charger entièrement la batterie au taux de charge actuel et à l’utilisation.

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

Notes

La classe Win32_PortableBattery est dérivée de CIM_Battery.

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