Win32_Battery 클래스

아티클
06/12/2023

Win32_BatteryWMI 클래스는 컴퓨터 시스템에 연결된 배터리를 나타냅니다.

다음 구문은 MOF(Managed Object Format) 코드를 단순화한 것으로 상속된 속성이 모두 포함되어 있습니다. 속성은 MOF 순서가 아닌 알파벳순으로 나열됩니다.

구문

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

멤버

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

메서드
속성

메서드

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

메서드	설명
재설정	구현되지 않았습니다. 이 메서드를 구현하려면 설명서에 대한 CIM_Battery Reset 메서드를 참조하세요.
SetPowerState	구현되지 않았습니다. 이 메서드를 구현하려면 설명서는 CIM_Battery SetPowerState 메서드를 참조하세요.

속성

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

디바이스가 조용합니다.

BatteryRechargeTime

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 사용되지 않음, MappingStrings("HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|RechargeRate"), 단위("분")

배터리를 완전히 충전하는 데 필요한 시간입니다. 이 속성이 지원되지 않는 경우 BatteryRechargeTime 에는 대체 속성이 없으며 이제 사용되지 않는 것으로 간주됩니다.

BatteryStatus

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

배터리의 상태입니다. 값 10(정의되지 않음)은 CIM 스키마에서 유효하지 않습니다. DMI에서는 배터리가 설치되지 않음을 나타내기 때문입니다. 이 경우 개체를 인스턴스화하면 안 됩니다.

이 속성은 CIM_Battery 상속됩니다.

기타 (1)

배터리가 방전됩니다.

알 수 없음 (2)

시스템에서 AC에 액세스할 수 있으므로 배터리가 방전되지 않습니다. 그러나 배터리가 반드시 충전되는 것은 아닙니다.

완전 충전 (3)

낮음 (4)

위험 (5)

충전 (6)

충전 및 높음 (7)

충전 및 낮음 (8)

충전 및 위험 (9)

정의 되지 않음(10)

부분적으로 청구됨 (11)

캡션

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

한 줄 문자열 개체에 대한 간단한 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

Chemistry

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

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

이 속성은 CIM_Battery 상속됩니다.

기타 (1)

알 수 없음 (2)

납산 (3)

니켈 카드미움 (4)

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

리튬 이온 (6)

아연 공기 (7)

리튬 폴리머 (8)

ConfigManagerErrorCode

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

Windows Configuration Manager 오류 코드입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

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

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

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

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

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

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

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

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

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

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

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

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

디바이스에 대한 부팅 구성이 다른 디바이스와 충돌합니다.

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

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

디바이스에 대한 드라이버 로더가 없습니다.

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

디바이스가 제대로 작동하지 않습니다. 제어 펌웨어가 디바이스에 대한 리소스를 잘못 보고하고 있습니다.

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

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

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

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

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

디바이스에서 사용할 충분한 무료 리소스를 찾을 수 없습니다.

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

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

컴퓨터를 다시 시작하기 전까지는 이 장치가 제대로 작동할 수 없습니다. (14)

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

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

가능한 다시 열거형 문제로 인해 디바이스가 제대로 작동하지 않습니다.

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

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

이 디바이스는 알 수 없는 리소스 유형을 요구합니다. (17)

디바이스에서 알 수 없는 리소스 종류를 요청하고 있습니다.

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

디바이스 드라이버를 다시 설치해야 합니다.

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

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

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

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

시스템 오류입니다. 디바이스 드라이버를 변경하는 것이 비효율적인 경우 하드웨어 설명서를 참조하세요. Windows에서 디바이스를 제거합니다.

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

디바이스를 사용할 수 없습니다.

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

시스템 오류입니다. 디바이스 드라이버를 변경하는 것이 비효율적인 경우 하드웨어 설명서를 참조하세요.

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

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

Windows에서 이 디바이스를 설정 중입니다. (25)

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

Windows에서 이 디바이스를 설정 중입니다. (26)

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

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

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

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

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

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

디바이스를 사용할 수 없습니다. 디바이스 펌웨어가 필요한 리소스를 제공하지 않았습니다.

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

디바이스가 다른 디바이스에서 사용하는 IRQ 리소스를 사용하고 있습니다.

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

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

ConfigManagerUserConfig

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

True이면 디바이스에서 사용자 정의 구성을 사용합니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

CreationClassName

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

인스턴스를 만드는 데 사용되는 상속 체인에 표시되는 첫 번째 구체적인 클래스의 이름입니다. 클래스의 다른 키 속성과 함께 사용하면 이 클래스의 모든 인스턴스와 해당 서브클래스를 고유하게 식별할 수 있습니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

설명

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

개체에 대한 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

DesignCapacity

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

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

이 속성은 CIM_Battery 상속됩니다.

DesignVoltage

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

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

이 속성은 CIM_Battery 상속됩니다.

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

DeviceID

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 키, 재정의("DeviceId"), MappingStrings("WMI")

배터리를 식별합니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

예: "내부 배터리"

ErrorCleared

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

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

이 속성은 CIM_LogicalDevice 상속됩니다.

ErrorDescription

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

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

이 속성은 CIM_LogicalDevice 상속됩니다.

EstimatedChargeRe기본ing

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

전체 충전 재기본 비율의 예상값입니다.

이 속성은 CIM_Battery 상속됩니다.

EstimatedRunTime

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

유틸리티 전원이 꺼져 있거나 분실 및기본 다시 꺼져 있거나 노트북이 전원에서 분리된 경우 현재 부하 조건에서 배터리 충전 고갈까지의 시간(분)을 추정합니다.

이 속성은 CIM_Battery 상속됩니다.

ExpectedBatteryLife

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 사용되지 않음, MappingStrings("HKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Services|BatteryLife"), 단위("분")

배터리가 완전히 충전된 후 배터리를 완전히 소모하는 데 걸리는 시간입니다. 이 속성은 더 이상 사용되지 않으며 사용되지 않는 것으로 간주됩니다.

ExpectedLife

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

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

이 속성은 CIM_Battery 상속됩니다.

FullChargeCapacity

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

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

이 속성은 CIM_Battery 상속됩니다.

InstallDate

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

개체가 설치된 날짜 및 시간입니다. 이 속성은 개체가 설치되었음을 나타내는 값이 필요하지 않습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

LastErrorCode

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

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

이 속성은 CIM_LogicalDevice 상속됩니다.

MaxRechargeTime

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

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

이 속성은 CIM_Battery 상속됩니다.

이름

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

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

이 속성은 CIM_ManagedSystemElement 상속됩니다.

PNPDeviceID

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

논리 디바이스의 Windows 플러그 앤 플레이 디바이스 식별자입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

예: "*PNP030b"

PowerManagementCapabilities

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

논리 디바이스의 특정 전원 관련 기능 배열입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

알 수 없음 (0)

지원 되지 않음(1)

사용 안 함 (2)

사용(3)

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

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

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

전원 상태 설정 가능 (5)

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

Power Cycling 지원 (6)

SetPowerState 메서드는 PowerState 매개 변수를 5(Power Cycle)로 설정하여 호출할 수 있습니다.

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

시간 제한 전원 켜기 지원

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

PowerManagementSupported

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

True이면 디바이스가 전원 관리될 수 있습니다(일시 중단 모드로 전환할 수 있음) 이 속성은 전원 관리 기능이 현재 사용하도록 설정되어 있음을 나타내지 않으며 논리 디바이스에서 전원을 관리할 수 있다는 것만 나타냅니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

SmartBatteryVersion

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

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

이 속성은 CIM_Battery 상속됩니다.

상태

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

개체의 현재 상태. 다양한 운영 및 비 운용 상태 정의할 수 있습니다. 작동 상태 "OK", "Degraded" 및 "Pred Fail"(SMART 지원 하드 디스크 드라이브와 같은 요소가 제대로 작동하지만 가까운 장래에 오류를 예측할 수 있음)이 포함됩니다. 비 운용성 상태에는 "오류", "시작 중", "중지" 및 "서비스"가 포함됩니다. 후자의 "서비스"는 디스크를 다시 미러, 사용자 권한 목록의 다시 로드 또는 기타 관리 작업 중에 적용할 수 있습니다. 이러한 모든 작업이 온라인 상태인 것은 아니지만 관리되는 요소는 "OK"도 아니고 다른 상태 중 하나도 아닙니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

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

확인 ("확인")

오류 ("오류")

성능이 저하됨 ("Degraded")

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

사전 실패 ("사전 실패")

시작 ("시작")

중지 ("중지")

서비스 ("서비스")

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

NonRecover ("NonRecover")

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

로스트 커밋 ("로스트 커밋")

StatusInfo

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

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

이 속성은 CIM_LogicalDevice 상속됩니다.

기타 (1)

알 수 없음 (2)

사용(3)

사용 안 함 (4)

해당 없음 (5)

SystemCreationClassName

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

범위 지정 컴퓨터 의 CreationClassName 속성 값입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

SystemName

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

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

이 속성은 CIM_LogicalDevice 상속됩니다.

TimeOnBattery

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

컴퓨터 시스템의 UPS가 마지막으로 배터리 전원으로 전환된 후 경과된 시간(초) 또는 시스템 또는 UPS가 마지막으로 다시 시작된 이후의 시간 중 더 적은 시간입니다. 배터리가 "on line"인 경우 0이 반환됩니다.

이 속성은 CIM_Battery 상속됩니다.

TimeToFullCharge

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

현재 충전 속도 및 사용량으로 배터리를 완전히 충전하는 데 몇 분 기본.

이 속성은 CIM_Battery 상속됩니다.

설명

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

Windows Server 2008에는 OS에 (APC) UPS 드라이버가 포함되어 있어 UPS를 배터리 공급 장치로 처리할 수 있습니다. 이렇게 하면 스크립트를 사용하여 UPS 상태 모니터링하고 필요한 경우 작업을 수행할 수 있습니다.

요구 사항

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

참고 항목

CIM_Battery
컴퓨터 시스템 하드웨어 클래스

Win32_Battery 클래스

구문

멤버

메서드

속성

설명

요구 사항

참고 항목

피드백

피드백

추가 리소스