Partilhar via

classe Win32_PortableBattery

  • Artigo

A classe WMIWin32_PortableBattery contém as propriedades relacionadas a uma bateria portátil, como uma bateria de computador notebook.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. Propriedades e métodos estão em ordem alfabética, não em ordem MOF.

Sintaxe

[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;
};

Membros

A classe Win32_PortableBattery tem estes tipos de membros:

Métodos

A classe Win32_PortableBattery tem esses métodos.

Método Descrição
Redefinir Não implementado. Para implementar esse método, consulte o método Reset em CIM_Battery.
SetPowerState Não implementado. Para implementar esse método, consulte o método SetPowerState em CIM_Battery.

 

Propriedades

A classe Win32_PortableBattery tem essas propriedades.

Disponibilidade

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Estado operacional|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

Disponibilidade e status do dispositivo.

Essa propriedade é herdada de CIM_LogicalDevice.

Outros (1)

Desconhecido (2)

Energia completa/em execução (3)

Energia completa ou em execução

Aviso (4)

Em Teste (5)

Não aplicável (6)

Desligar (7)

Off Line (8)

Desativada (9)

Degradado (10)

Não Instalado (11)

Erro de instalação (12)

Economia de energia – Desconhecido (13)

O dispositivo é conhecido por estar em um modo de economia de energia, mas seu status exato é desconhecido.

Economia de energia – modo de energia baixa (14)

O dispositivo está em um estado de economia de energia, mas ainda funcionando e pode apresentar desempenho degradado.

Economia de energia – espera (15)

O dispositivo não está funcionando, mas pode ser levado à potência total rapidamente.

Ciclo de Energia (16)

Economia de energia – Aviso (17)

O dispositivo está em um estado de aviso, embora também em um modo de economia de energia.

Pausado (18)

O dispositivo está em pausa.

Não Pronto (19)

O dispositivo não está pronto.

Não Configurado (20)

O dispositivo não está configurado.

Quiesced (21)

O dispositivo está silencioso.

BatteryStatus

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Bateria portátil|002.14")

Descrição da carga da bateria status. O valor 10 (Indefinido) não é válido no esquema CIM (Common Information Model) porque na DMI (Interface de Gerenciamento de Área de Trabalho) indica que nenhuma bateria está instalada. Nesse caso, esse objeto não deve ser instanciado.

Essa propriedade é herdada de CIM_Battery.

Outros (1)

Desconhecido (2)

Totalmente cobrado (3)

Baixo (4)

Crítico (5)

Carregamento (6)

Carregamento e Alta (7)

Carregamento e baixo (8)

Carregamento e crítico (9)

Indefinido (10)

Parcialmente cobrado (11)

CapacityMultiplier

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("SMBIOS| Tipo 22| Multiplicador de Capacidade de Design")

Fator de multiplicação do valor DesignCapacity para garantir que o valor de miliwatt-hora não estoura para implementações de SBDS (Especificação de Dados de Bateria Inteligente).

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64), DisplayName ("Caption")

Descrição curta do objeto — uma cadeia de caracteres de uma linha.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Química

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Bateria portátil|002.7")

Química da bateria.

Essa propriedade é herdada de CIM_Battery.

Outros (1)

Desconhecido (2)

Ácido de chumbo (3)

Níquel Cadmium (4)

Hydride metal de níquel (5)

Íon-lítio (6)

Ar de zinco (7)

Polímero de lítio (8)

ConfigManagerErrorCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

Win32 Configuration Manager código de erro.

Essa propriedade é herdada de CIM_LogicalDevice.

Este dispositivo está funcionando corretamente. (0)

O dispositivo está funcionando corretamente.

Este dispositivo não está configurado corretamente. (1)

O dispositivo não está configurado corretamente.

O Windows não pode carregar o driver para este dispositivo. (2)

O driver desse dispositivo pode estar corrompido ou o sistema pode estar com pouca memória ou outros recursos. (3)

O driver desse dispositivo pode estar corrompido ou o sistema pode ter pouca memória ou outros recursos.

Este dispositivo não está funcionando corretamente. Um de seus drivers ou seu registro pode estar corrompido. (4)

O dispositivo não está funcionando corretamente. Um de seus drivers ou o registro pode estar corrompido.

O driver deste dispositivo precisa de um recurso que o Windows não possa gerenciar. (5)

O driver do dispositivo requer um recurso que o Windows não pode gerenciar.

A configuração de inicialização deste dispositivo está em conflito com outros dispositivos. (6)

A configuração de inicialização do dispositivo está em conflito com outros dispositivos.

Não é possível filtrar. (7)

O carregador de driver para o dispositivo está ausente. (8)

O carregador de driver para o dispositivo está ausente.

Esse dispositivo não está funcionando corretamente porque o firmware de controle está relatando os recursos para o dispositivo incorretamente. (9)

O dispositivo não está funcionando corretamente. O firmware de controle está relatando incorretamente os recursos para o dispositivo.

Este dispositivo não pode ser iniciado. (10)

O dispositivo não pode ser iniciado.

Este dispositivo falhou. (11)

Falha no dispositivo.

Este dispositivo não pode encontrar recursos livres suficientes que ele pode usar. (12)

O dispositivo não pode encontrar recursos gratuitos suficientes para usar.

O Windows não pode verificar os recursos deste dispositivo. (13)

O Windows não pode verificar os recursos do dispositivo.

Este dispositivo não pode funcionar corretamente até que você reinicie o computador. (14)

O dispositivo não pode funcionar corretamente até que o computador seja reiniciado.

Esse dispositivo não está funcionando corretamente porque provavelmente há um problema de renumeração. (15)

O dispositivo não está funcionando corretamente devido a um possível problema de renumeração.

O Windows não pode identificar todos os recursos que este dispositivo usa. (16)

O Windows não pode identificar todos os recursos que o dispositivo usa.

Este dispositivo está solicitando um tipo de recurso desconhecido. (17)

O dispositivo está solicitando um tipo de recurso desconhecido.

Reinstale os drivers para este dispositivo. (18)

Os drivers de dispositivo devem ser reinstalados.

Falha ao usar o carregador VxD. (19)

Seu registro pode estar corrompido. (20)

O Registro pode estar corrompido.

Falha do sistema: tente alterar o driver para este dispositivo. Se isso não funcionar, consulte a documentação de hardware. O Windows está removendo este dispositivo. (21)

Falha do sistema. Se a alteração do driver do dispositivo for ineficaz, consulte a documentação de hardware. O Windows está removendo o dispositivo.

Este dispositivo está desabilitado. (22)

O dispositivo está desabilitado.

Falha do sistema: tente alterar o driver para este dispositivo. Se isso não funcionar, consulte a documentação de hardware. (23)

Falha do sistema. Se a alteração do driver do dispositivo for ineficaz, consulte a documentação de hardware.

Este dispositivo não está presente, não está funcionando corretamente ou não tem todos os drivers instalados. (24)

O dispositivo não está presente, não está funcionando corretamente ou não tem todos os drivers instalados.

O Windows ainda está configurando esse dispositivo. (25)

O Windows ainda está configurando o dispositivo.

O Windows ainda está configurando esse dispositivo. (26)

O Windows ainda está configurando o dispositivo.

Este dispositivo não tem uma configuração de log válida. (27)

O dispositivo não tem configuração de log válida.

Os drivers deste dispositivo não estão instalados. (28)

Os drivers de dispositivo não estão instalados.

Esse dispositivo está desabilitado porque o firmware do dispositivo não lhe deu os recursos necessários. (29)

O dispositivo está desabilitado. O firmware do dispositivo não forneceu os recursos necessários.

Esse dispositivo está usando um recurso irq (solicitação de interrupção) que outro dispositivo está usando. (30)

O dispositivo está usando um recurso IRQ que outro dispositivo está usando.

Este dispositivo não está funcionando corretamente porque o Windows não pode carregar os drivers necessários para este dispositivo. (31)

O dispositivo não está funcionando corretamente. O Windows não pode carregar os drivers de dispositivo necessários.

ConfigManagerUserConfig

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

Se TRUE, o dispositivo está usando uma configuração definida pelo usuário.

Essa propriedade é herdada de CIM_LogicalDevice.

CreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: CIM_Key

Nome da primeira classe concreta que aparece na cadeia de herança usada na criação de uma instância. Quando usada com as outras propriedades principais da classe, a propriedade permite que todas as instâncias dessa classe e suas subclasses sejam identificadas exclusivamente.

Essa propriedade é herdada de CIM_LogicalDevice.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Description")

Descrição do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

DesignCapacity

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Bateria portátil|002,8"), unidades ("milliwatt-hours")

Projete a capacidade da bateria em miliwatts-hora. Se essa propriedade não tiver suporte, insira 0 (zero).

Essa propriedade é herdada de CIM_Battery.

DesignVoltage

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Bateria Portátil|002.9"), Unidades ("milisvoltas")

Tensão de design da bateria em milisvoltas. Se esse atributo não tiver suporte, insira 0 (zero).

Essa propriedade é herdada de CIM_Battery.

Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.

Deviceid

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Chave, Substituição ("DeviceId"), MappingStrings ("WMI")

Identificador de bateria.

Essa propriedade é herdada de CIM_LogicalDevice.

Exemplo: "Bateria Interna"

ErrorCleared

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se TRUE, o erro relatado em LastErrorCode agora será limpo.

Essa propriedade é herdada de CIM_LogicalDevice.

ErrorDescription

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Mais informações sobre o erro registrado em LastErrorCode e as ações corretivas que podem ser executadas.

Essa propriedade é herdada de CIM_LogicalDevice.

EstimatedChargeRemaining

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: Unidades ("porcentagem")

Estimativa do percentual de cobrança total restante.

Essa propriedade é herdada de CIM_Battery.

EstimatedRunTime

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Bateria Portátil|002.15"), Unidades ("minutos")

Estimar em minutos o esgotamento da carga da bateria sob as condições de carga atuais se a energia do utilitário estiver desligada ou perdida e permanecer desligada, ou se um laptop estiver desconectado de uma fonte de energia.

Essa propriedade é herdada de CIM_Battery.

ExpectedBatteryLife

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Sem suporte.

Essa propriedade é herdada de CIM_Battery.

ExpectedLife

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: Unidades ("minutos")

Tempo de vida esperado da bateria em minutos, supondo que a bateria esteja totalmente carregada. Essa propriedade representa a vida útil total esperada da bateria, não sua vida útil restante atual, que é indicada pela propriedade EstimatedRunTime .

Essa propriedade é herdada de CIM_Battery.

FullChargeCapacity

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Bateria Portátil|002.11"), Unidades ("miliwatts-hora")

Capacidade de carga total da bateria em miliwatts-hora. A comparação desse valor com a propriedade DesignCapacity determina quando a bateria requer substituição. O fim da vida útil de uma bateria é normalmente quando a propriedade FullChargeCapacity fica abaixo de 80% da propriedade DesignCapacity . Se essa propriedade não tiver suporte, insira 0 (zero).

Essa propriedade é herdada de CIM_Battery.

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")

Data e hora em que o objeto foi instalado. Essa propriedade não precisa de um valor para indicar que o objeto está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

LastErrorCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Último código de erro relatado pelo dispositivo lógico.

Essa propriedade é herdada de CIM_LogicalDevice.

Localidade

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("SMBIOS| Tipo 22| Local")

Local físico da bateria. Essa propriedade é preenchida pelo fabricante do computador.

Exemplo: "Na parte de trás, à esquerda"

ManufactureDate

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("SMBIOS| Tipo 22| Data de fabricação")

Data em que a bateria foi fabricada.

Fabricante

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("SMBIOS| Tipo 22| Fabricante")

Fabricante da bateria.

MaxBatteryError

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("SMBIOS| Tipo 22| Erro máximo em dados de bateria"), unidades ("porcentagem")

Diferença entre a maior quantidade estimada de energia restante na bateria e a quantidade atual relatada pela bateria.

MaxRechargeTime

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: Unidades ("minutos")

Tempo máximo, em minutos, para carregar totalmente a bateria. Essa propriedade representa o tempo para recarregar uma bateria totalmente esgotada, não o tempo de carga restante atual, que é indicado na propriedade TimeToFullCharge .

Essa propriedade é herdada de CIM_Battery.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Name")

Rótulo pelo qual o objeto é conhecido. Quando subclasse, a propriedade pode ser substituída para ser uma propriedade de chave.

Essa propriedade é herdada de CIM_ManagedSystemElement.

PNPDeviceID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

O Windows Plug and Play identificador de dispositivo do dispositivo lógico.

Essa propriedade é herdada de CIM_LogicalDevice.

Exemplo: "*PNP030b"

PowerManagementCapabilities

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Matriz das funcionalidades específicas relacionadas à energia de um dispositivo lógico.

Essa propriedade é herdada de CIM_LogicalDevice.

Desconhecido (0)

Sem suporte (1)

Desabilitado (2)

Habilitado (3)

Os recursos de gerenciamento de energia estão habilitados no momento, mas o conjunto exato de recursos é desconhecido ou as informações não estão disponíveis.

Modos de economia de energia inseridos automaticamente (4)

O dispositivo pode alterar seu estado de energia com base no uso ou em outros critérios.

Power State Settable (5)

Há suporte para o método SetPowerState . Esse método é encontrado na classe de CIM_LogicalDevice pai e pode ser implementado. Para obter mais informações, consulte Criando classes MOF (Formato de Objeto Gerenciado).

Power Cycling com suporte (6)

O método SetPowerState pode ser invocado com o parâmetro PowerState definido como 5 (Power Cycle).

Com suporte para Ligar /Hora (7)

Com suporte para Power-On cronometrado

O método SetPowerState pode ser invocado com o parâmetro PowerState definido como 5 (Power Cycle) e Time definido como uma data e hora específicas, ou intervalo, para ativação.

PowerManagementSupported

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se TRUE, o dispositivo poderá ser gerenciado por energia (pode ser colocado no modo de suspensão e assim por diante). A propriedade não indica que os recursos de gerenciamento de energia estão habilitados no momento, apenas que o dispositivo lógico é capaz de gerenciamento de energia.

Essa propriedade é herdada de CIM_LogicalDevice.

SmartBatteryVersion

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64), MappingStrings ("MIF. DMTF| Bateria portátil|002.10")

Número de versão da Especificação de Dados de Bateria Inteligente com suporte nesta bateria. Se a bateria não der suporte a essa função, o valor deverá ser deixado em branco.

Essa propriedade é herdada de CIM_Battery.

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (10), DisplayName ("Status")

Status atual do objeto. Vários status operacionais e não operacionais podem ser definidos. Os status operacionais incluem: "OK", "Degradado" e "Falha de Pred" (um elemento, como uma unidade de disco rígido habilitada para SMART, pode estar funcionando corretamente, mas prevendo uma falha em um futuro próximo). Os status não operacionais incluem: "Erro", "Iniciando", "Parando" e "Serviço". Este último, "Serviço", pode ser aplicado durante espelho resilvering de um disco, recarregamento de uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Falha de pred ("Falha de pred")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem contato ("Sem contato")

Comm Perdido ("Comm Perdido")

StatusInfo

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Estado Operacional|003.3")

Estado do dispositivo lógico. Se essa propriedade não se aplicar ao dispositivo lógico, o valor 5 (Não Aplicável) deverá ser usado.

Essa propriedade é herdada de CIM_LogicalDevice.

Outros (1)

Desconhecido (2)

Habilitado (3)

Desabilitado (4)

Não aplicável (5)

SystemCreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Propagado ("CIM_System. CreationClassName"), CIM_Key

Valor da propriedade CreationClassName do computador de escopo.

Essa propriedade é herdada de CIM_LogicalDevice.

Systemname

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Propagado ("CIM_System. Nome"), CIM_Key

Nome do sistema de escopo.

Essa propriedade é herdada de CIM_LogicalDevice.

TimeOnBattery

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: Unidades ("segundos")

Tempo decorrido em segundos desde que o UPS do sistema de computador mudou pela última vez para a energia da bateria, ou o tempo desde que o sistema ou UPS foi reiniciado pela última vez, o que for menor. Se a bateria estiver online, 0 (zero) será retornado.

Essa propriedade é herdada de CIM_Battery.

TimeToFullCharge

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Bateria portátil|002.16"), unidades ("minutos")

Tempo restante em minutos para carregar a bateria totalmente na taxa de carga e no uso atuais.

Essa propriedade é herdada de CIM_Battery.

Comentários

A classe Win32_PortableBattery é derivada de CIM_Battery.

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista
Servidor mínimo com suporte
 Windows Server 2008
Namespace
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Confira também

CIM_Battery

Classes de hardware do sistema de computador