CIM_Battery 클래스

아티클
06/13/2023

CIM_Battery 클래스는 배터리 논리 디바이스의 기능 및 관리를 나타냅니다. 이 클래스는 노트북 시스템 및 기타 내부 및 외부 배터리의 배터리에 적용됩니다.

중요

DMTF(분산 관리 태스크 포스) CIM(일반 정보 모델) 클래스는 WMI 클래스를 빌드하는 부모 클래스입니다. WMI는 현재 CIM 2.x 버전 스키마만 지원합니다.

MOF(Managed Object Format) 코드에서 간결하게 표기된 다음 구문은 상속된 속성을 모두 포함합니다. 속성은 MOF 순서가 아닌 알파벳순으로 나열됩니다.

구문

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

멤버

CIM_Battery 클래스에는 다음과 같은 유형의 멤버가 있습니다.

메서드
속성

메서드

CIM_Battery 클래스에는 이러한 메서드가 있습니다.

메서드	Description
다시 설정	논리 디바이스의 초기화를 요청합니다. WMI에서 구현되지 않습니다.
SetPowerState	논리 디바이스에 대해 원하는 전원 상태와 디바이스를 해당 상태로 전환해야 하는 시기를 정의합니다. WMI에서 구현되지 않습니다.

속성

CIM_Battery 클래스에는 이러한 속성이 있습니다.

가용성

데이터 형식: uint16
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| 작동 상태|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

디바이스의 가용성 및 상태.

이 속성은 CIM_LogicalDevice 상속됩니다.

기타 (1)

알 수 없음 (2)

실행 중/전체 전원 (3)

경고 (4)

테스트 중 (5)

해당 없음 (6)

전원 끄기 (7)

오프라인 (8)

오프 듀티 (9)

저하됨 (10)

설치되지 않음 (11)

설치 오류 (12)

절전 - 알 수 없음 (13)

디바이스는 절전 모드인 것으로 알려져 있지만 정확한 상태 알 수 없습니다.

절전 - 저전력 모드 (14)

디바이스가 절전 상태이지만 여전히 작동 중이며 성능이 저하될 수 있습니다.

절전 - 대기 (15)

디바이스가 작동하지 않지만 신속하게 전체 전원을 공급할 수 있습니다.

전원 주기 (16)

절전 - 경고 (17)

절전 모드에서도 디바이스가 경고 상태입니다.

일시 중지됨 (18)

디바이스가 일시 중지되었습니다.

준비되지 않음 (19)

디바이스가 준비되지 않았습니다.

구성되지 않음 (20)

장치가 구성되지 않았습니다.

정지됨 (21)

장치가 조용합니다.

BatteryStatus

데이터 형식: uint16
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| 휴대용 배터리|002.14")

배터리 충전 상태 대한 설명입니다. 값 10은 DMI(데스크톱 관리 인터페이스)에 설치된 배터리가 없음을 나타내는 CIM 스키마에서 유효하지 않습니다. 이 경우 개체를 인스턴스화하면 안 됩니다.

기타 (1)

기타.

알 수 없음 (2)

알 수 없습니다.

완전 충전 (3)

완전히 충전되었습니다.

낮음 (4)

낮음.

위험 (5)

심각.

충전 (6)

충전.

충전 및 높음 (7)

충전 및 높음.

충전 및 낮음 (8)

충전 및 낮음.

충전 및 중요 (9)

충전 및 중요.

정의되지 않음 (10)

정의되지 않았습니다.

부분 청구 (11)

부분적으로 청구됩니다.

캡션

데이터 형식: string
액세스 형식: 읽기 전용
한정자: MaxLen (64), DisplayName ("Caption")

개체에 대한 간단한 텍스트 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

Chemistry

데이터 형식: uint16
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| 휴대용 배터리|002.7")

배터리의 화학을 설명하는 열거형입니다.

기타 (1)

기타.

알 수 없음 (2)

알 수 없습니다.

납산 (3)

납축.

니켈 카드미움 (4)

니켈 카드미움.

니켈 금속 하이드라이드 (5)

니켈 금속 하이드라이드.

리튬 이온 (6)

리튬 이온.

아연 공기 (7)

아연 공기.

리튬 폴리머 (8)

리튬 폴리머.

ConfigManagerErrorCode

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32")

Win32 Configuration Manager 오류 코드입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

이 디바이스가 제대로 작동합니다. (0)

이 디바이스가 올바르게 구성되지 않았습니다. (1)

Windows에서 이 디바이스에 대한 드라이버를 로드할 수 없습니다. (2)

이 디바이스의 드라이버가 손상되었거나 시스템에서 메모리 또는 기타 리소스가 부족할 수 있습니다. (3)

이 디바이스가 제대로 작동하지 않습니다. 드라이버 또는 레지스트리 중 하나가 손상되었을 수 있습니다. (4)

이 디바이스의 드라이버에는 Windows에서 관리할 수 없는 리소스가 필요합니다. (5)

이 디바이스의 부팅 구성이 다른 디바이스와 충돌합니다. (6)

필터링할 수 없습니다. (7)

디바이스의 드라이버 로더가 없습니다. (8)

제어 펌웨어가 디바이스의 리소스를 잘못 보고하기 때문에 이 디바이스가 제대로 작동하지 않습니다. (9)

이 디바이스를 시작할 수 없습니다. (10)

이 디바이스가 실패했습니다. (11)

이 디바이스는 사용할 수 있는 충분한 사용 가능한 리소스를 찾을 수 없습니다. (12)

Windows에서 이 디바이스의 리소스를 확인할 수 없습니다. (13)

컴퓨터를 다시 시작할 때까지 이 디바이스가 제대로 작동할 수 없습니다. (14)

다시 열거형 문제가 있을 수 있으므로 이 디바이스가 제대로 작동하지 않습니다. (15)

Windows는 이 디바이스에서 사용하는 모든 리소스를 식별할 수 없습니다. (16)

이 디바이스는 알 수 없는 리소스 종류를 요구합니다. (17)

이 디바이스에 대한 드라이버를 다시 설치합니다. (18)

VxD 로더를 사용하지 못했습니다. (19)

레지스트리가 손상되었을 수 있습니다. (20)

시스템 오류: 이 디바이스의 드라이버를 변경해 보세요. 작동하지 않는 경우 하드웨어 설명서를 참조하세요. Windows에서 이 디바이스를 제거합니다. (21)

이 디바이스는 사용할 수 없습니다. (22)

시스템 오류: 이 디바이스의 드라이버를 변경해 보세요. 작동하지 않는 경우 하드웨어 설명서를 참조하세요. (23)

이 디바이스가 없거나, 제대로 작동하지 않거나, 모든 드라이버가 설치되어 있지 않습니다. (24)

Windows는 여전히 이 디바이스를 설정하고 있습니다. (25)

Windows는 여전히 이 디바이스를 설정하고 있습니다. (26)

이 디바이스에는 유효한 로그 구성이 없습니다. (27)

이 디바이스의 드라이버가 설치되지 않았습니다. (28)

디바이스의 펌웨어가 필요한 리소스를 제공하지 않았기 때문에 이 디바이스를 사용할 수 없습니다. (29)

이 디바이스는 다른 디바이스에서 사용하는 IRQ(인터럽트 요청) 리소스를 사용하고 있습니다. (30)

Windows에서 이 디바이스에 필요한 드라이버를 로드할 수 없으므로 이 디바이스가 제대로 작동하지 않습니다. (31)

ConfigManagerUserConfig

데이터 형식: boolean
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32")

TRUE이면 디바이스가 사용자 정의 구성을 사용하고 있습니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

CreationClassName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: CIM_Key

instance 만드는 데 사용되는 클래스 또는 하위 클래스의 이름입니다. 클래스의 다른 키 속성과 함께 사용할 경우 이 속성을 사용하면 클래스 및 해당 하위 클래스의 모든 인스턴스를 고유하게 식별할 수 있습니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

설명

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: DisplayName ("Description")

개체에 대한 텍스트 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

DesignCapacity

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| 휴대용 배터리|002.8"), 단위 ("밀리와트시")

배터리 용량을 밀리와트시 단위로 설계했습니다. 이 속성이 지원되지 않는 경우 0을 입력합니다.

DesignVoltage

데이터 형식: uint64
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| 휴대용 배터리|002.9"), 단위 ("밀리볼트")

배터리의 전압을 밀리볼트 단위로 설계했습니다. 이 특성이 지원되지 않는 경우 0을 입력합니다.

스크립트에서 uint64 값을 사용하는 방법에 대한 자세한 내용은 WMI 스크립트 만들기를 참조하세요.

DeviceID

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: CIM_Key

논리 디바이스의 이름을 고유하게 지정하기 위한 주소 또는 기타 식별 정보입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

ErrorCleared

데이터 형식: boolean
액세스 형식: 읽기 전용

TRUE이면 LastErrorCode 속성에 보고된 오류가 이제 지워집니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

ErrorDescription

데이터 형식: string
액세스 형식: 읽기 전용

LastErrorCode 속성에 기록된 오류 및 수행할 수정 작업에 대한 정보를 제공하는 자유 형식 문자열입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

EstimatedChargeRemaining

데이터 형식: uint16
액세스 형식: 읽기 전용
한정자: 단위 ("백분율")

남은 전체 요금의 예상 백분율입니다.

EstimatedRunTime

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| 휴대용 배터리|002.15"), 단위 ("분")

유틸리티 전원이 꺼져 있고 꺼져 있거나 노트북이 전원에서 분리된 경우 현재 부하 조건에서 배터리 충전이 고갈될 때까지의 예상 시간(분)입니다.

ExpectedLife

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 단위 ("분")

배터리가 완전히 충전된 것으로 가정하면 배터리의 예상 수명(분)입니다. 이 속성은 EstimatedRunTime 속성으로 표시된 현재 남은 수명이 아닌 배터리의 예상 총 수명을 나타냅니다.

FullChargeCapacity

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| 휴대용 배터리|002.11"), 단위 ("밀리와트시")

배터리의 전체 충전 용량(밀리와트시)입니다. 이 값을 DesignCapacity 속성과 비교하여 배터리에 교체가 필요한 시기를 결정합니다. 배터리의 종료 수명은 일반적으로 FullChargeCapacity 속성이 DesignCapacity 속성의 80% 미만으로 떨어질 때입니다. 이 속성이 지원되지 않는 경우 0을 입력합니다.

InstallDate

데이터 형식: datetime
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("설치 날짜")

개체가 설치된 시기를 나타냅니다. 값이 부족해도 개체가 설치되지 않았음을 의미하지는 않습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

LastErrorCode

데이터 형식: uint32
액세스 형식: 읽기 전용

논리 디바이스에서 보고한 마지막 오류 코드입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

MaxRechargeTime

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 단위 ("분")

배터리를 완전히 충전하는 최대 시간(분)입니다. 이 속성은 TimeToFullCharge 속성에 표시된 현재 남은 충전 시간이 아니라 완전히 고갈된 배터리를 충전하는 시간을 나타냅니다.

이름

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: DisplayName ("Name")

개체가 알려진 레이블입니다. 서브클래스를 사용하면 이 속성을 키 속성으로 재정의할 수 있습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

PNPDeviceID

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32")

논리 디바이스의 Win32 플러그 앤 플레이 디바이스 식별자를 나타냅니다.

예: "*PNP030b"

이 속성은 CIM_LogicalDevice 상속됩니다.

PowerManagementCapabilities

데이터 형식: uint16 배열
액세스 형식: 읽기 전용

논리 디바이스의 특정 전원 관련 기능을 나타냅니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

알 수 없음 (0)

전원 관련 용량을 알 수 없습니다.

지원되지 않음 (1)

이 디바이스에는 전원 관련 용량이 지원되지 않습니다.

사용 안 함 (2)

전원 관련 용량이 비활성화되었습니다.

사용 (3)

전원 관리 기능은 현재 사용하도록 설정되어 있지만 정확한 기능 집합을 알 수 없거나 정보를 사용할 수 없습니다.

절전 모드가 자동으로 입력됨 (4)

디바이스는 사용량 또는 기타 기준에 따라 전원 상태를 변경할 수 있습니다.

전원 상태 설정 가능 (5)

SetPowerState 메서드가 지원됩니다. 이 메서드는 부모 CIM_LogicalDevice 클래스에서 찾을 수 있으며 구현할 수 있습니다. 자세한 내용은 MOF(Managed Object Format) 클래스 디자인을 참조하세요.

지원되는 파워 사이클링 (6)

SetPowerState 메서드는 PowerState 매개 변수를 5("전원 주기")로 설정하여 호출할 수 있습니다.

시간 제한 전원 켜기 지원 됨(7)

SetPowerState 메서드는 PowerState 매개 변수를 5("전원 주기")로 설정하고 Time 매개 변수를 전원 켜기에 대해 특정 날짜 및 시간 또는 간격으로 설정하여 호출할 수 있습니다.

PowerManagementSupported

데이터 형식: boolean
액세스 형식: 읽기 전용

TRUE이면 디바이스는 전원 관리, 즉 절전 상태로 전환될 수 있습니다. FALSE이면 정수 값 1("지원되지 않음")이 PowerManagementCapabilities 배열의 유일한 항목이어야 합니다.

이 속성은 전원 관리 기능이 현재 활성화되어 있는지 또는 활성화되어 있는지 여부를 나타내지 않습니다. 자세한 내용은 PowerManagementCapabilities 배열을 참조하세요.

이 속성은 CIM_LogicalDevice 상속됩니다.

SmartBatteryVersion

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MaxLen (64), MappingStrings ("MIF. DMTF| 휴대용 배터리|002.10")

이 배터리에서 지원하는 스마트 배터리 데이터 사양 버전 번호입니다. 배터리가 이 함수를 지원하지 않는 경우 값을 비워 두어야 합니다.

상태

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MaxLen (10), DisplayName ("상태")

개체의 현재 상태 나타내는 문자열입니다. 운영 및 비운용 상태 정의할 수 있습니다. 운영 상태 "확인", "저하됨" 및 "사전 실패"를 포함할 수 있습니다. "Pred Fail"은 요소가 제대로 작동하지만 오류를 예측하고 있음을 나타냅니다(예: SMART 지원 하드 디스크 드라이브).

비작동 상태 "오류", "시작", "중지" 및 "서비스"를 포함할 수 있습니다. 디스크 미러 다시 실행, 사용자 권한 목록 다시 로드 또는 기타 관리 작업 중에 "서비스"를 적용할 수 있습니다. 이러한 모든 작업이 온라인 상태인 것은 아니지만 관리되는 요소는 "OK"도 아니고 다른 상태 중 하나도 아닙니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

여기에는 다음 값이 포함됩니다.

확인 ("확인")

오류 ("오류")

저하됨 ("성능 저하")

알 수 없음 ("알 수 없음")

Pred Fail ("Pred Fail")

시작 ("시작")

중지 ("중지")

서비스 ("서비스")

스트레스( "스트레스")

NonRecover ("NonRecover")

연락처 없음 ("연락처 없음")

Lost Comm ("Lost Comm")

StatusInfo

데이터 형식: uint16
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| 작동 상태|003.3")

논리 디바이스의 상태입니다. 이 속성이 논리 디바이스에 적용되지 않는 경우 값 5("해당 없음")를 사용해야 합니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

기타 (1)

알 수 없음 (2)

사용 (3)

사용 안 함 (4)

해당 없음 (5)

SystemCreationClassName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 전파( "CIM_System. CreationClassName"), CIM_Key

범위 지정 시스템의 생성 클래스 이름입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

SystemName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 전파( "CIM_System. 이름"), CIM_Key

범위 지정 시스템의 이름입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

TimeOnBattery

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 단위 ("초")

컴퓨터 시스템의 UPS가 마지막으로 배터리 전원으로 전환되었거나 시스템 또는 UPS가 마지막으로 다시 시작된 이후의 시간(초)이 경과되었습니다. 배터리가 "온라인"인 경우 값 0이 반환됩니다.

TimeToFullCharge

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| 휴대용 배터리|002.16"), 단위 ("분")

배터리를 현재 충전 속도로 완전히 충전하고 사용하는 데 남은 시간(분)입니다.

설명

CIM_Battery 클래스는 CIM_LogicalDevice 파생됩니다.

WMI는 이 클래스를 구현하지 않습니다. CIM_Battery 파생된 클래스에 대한 자세한 내용은 Win32 클래스를 참조하세요.

이 설명서는 DMTF에서 게시한 CIM 클래스 설명을 바탕으로 합니다. Microsoft에서 사소한 오류를 수정하거나, Microsoft SDK 설명서 표준을 준수하거나, 자세한 정보를 제공하기 위해 내용을 변경했을 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
네임스페이스	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

추가 정보

CIM_LogicalDevice

CIM_Battery 클래스

구문

멤버

메서드

속성

설명

요구 사항

추가 정보

피드백

피드백

추가 리소스