Win32_PortableBattery 클래스

Win32_PortableBatteryWMI 클래스에는 노트북 컴퓨터 배터리와 같은 휴대용 배터리와 관련된 속성이 포함되어 있습니다.

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

구문

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

멤버

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

• 메서드
• 속성

메서드

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

메서드	Description
Reset	구현되지 않았습니다. 이 메서드를 구현하려면 CIM_BatteryReset 메서드를 참조하세요.
SetPowerState	구현되지 않았습니다. 이 메서드를 구현하려면 CIM_BatterySetPowerState 메서드를 참조하세요.

 

속성

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

가용성

데이터 형식: 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(정의되지 않음)은 CIM(일반 정보 모델) 스키마에서 유효하지 않습니다. DMI(데스크톱 관리 인터페이스)에서는 배터리가 설치되지 않음을 나타내기 때문입니다. 이 경우 이 개체를 인스턴스화하면 안 됩니다.

이 속성은 CIM_Battery 상속됩니다.

기타 (1)

알 수 없음 (2)

완전 충전 (3)

낮음 (4)

위험 (5)

충전 (6)

충전 및 높음 (7)

충전 및 낮음 (8)

충전 및 중요 (9)

정의되지 않음 (10)

부분 청구 (11)

CapacityMultiplier

데이터 형식: uint16

액세스 형식: 읽기 전용

한정자: MappingStrings ("SMBIOS| 형식 22| 용량 승수 디자인")

SBDS(스마트 배터리 데이터 사양) 구현에 밀리와트시 값이 오버플로되지 않도록 DesignCapacity 값의 곱셈 요소입니다.

캡션

데이터 형식: 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")

Win32 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

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

이 속성은 CIM_LogicalDevice 상속됩니다.

설명

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: DisplayName ("설명")

개체에 대한 설명입니다.

이 속성은 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 상속됩니다.

EstimatedChargeRemaining

데이터 형식: uint16

액세스 형식: 읽기 전용

한정자: 단위 ("백분율")

남은 전체 요금의 백분율을 예측합니다.

이 속성은 CIM_Battery 상속됩니다.

EstimatedRunTime

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("MIF. DMTF| 휴대용 배터리|002.15"), 단위 ("분")

유틸리티 전원이 꺼져 있거나 분실되고 꺼져 있거나 노트북이 전원에서 연결이 끊어진 경우 현재 부하 조건에서 배터리 충전 고갈 시간(분)을 예측합니다.

이 속성은 CIM_Battery 상속됩니다.

ExpectedBatteryLife

데이터 형식: uint32

액세스 형식: 읽기 전용

지원되지 않습니다.

이 속성은 CIM_Battery 상속됩니다.

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 상속됩니다.

위치

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("SMBIOS| 형식 22| 위치")

배터리의 물리적 위치입니다. 이 속성은 컴퓨터 제조업체에 의해 채워집니다.

예: "뒤로, 왼쪽"

ManufactureDate

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("SMBIOS| 형식 22| 제조 날짜")

배터리가 제조된 날짜입니다.

제조업체

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("SMBIOS| 형식 22| 제조업체")

배터리 제조업체.

MaxBatteryError

데이터 형식: uint16

액세스 형식: 읽기 전용

한정자: MappingStrings ("SMBIOS| 형식 22| 배터리 데이터의 최대 오류"), 단위 ("백분율")

배터리에 남아 있는 가장 높은 예상 에너지 양과 배터리가 보고한 현재 양 간의 차이입니다.

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)

시간 제한 Power-On 지원됨

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

PowerManagementSupported

데이터 형식: boolean

액세스 형식: 읽기 전용

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

이 속성은 CIM_LogicalDevice 상속됩니다.

SmartBatteryVersion

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MaxLen (64), MappingStrings ("MIF. DMTF| 휴대용 배터리|002.10")

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

이 속성은 CIM_Battery 상속됩니다.

상태

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MaxLen (10), DisplayName ("상태")

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

이 속성은 CIM_ManagedSystemElement 상속됩니다.

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

OK ("OK")

오류 ("오류")

성능 저하됨 ("Degraded")

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

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

시작 중("시작")

중지 ("중지")

서비스 ("서비스")

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

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

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

이 속성은 CIM_LogicalDevice 상속됩니다.

SystemName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: 전파됨 ("CIM_System. 이름"), CIM_Key

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

이 속성은 CIM_LogicalDevice 상속됩니다.

TimeOnBattery

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: 단위 ("초")

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

이 속성은 CIM_Battery 상속됩니다.

TimeToFullCharge

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("MIF. DMTF| 휴대용 배터리|002.16"), 단위 ("분")

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

이 속성은 CIM_Battery 상속됩니다.

설명

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

요구 사항

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

추가 정보

CIM_Battery

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