CIM_UninterruptiblePowerSupply 类

项目
06/13/2023

CIM_UninterruptiblePowerSupply 类表示不间断电源的功能和管理 (UPS) 。 UPS 设备的属性指示何时修整或提升传入电源，以及构成设备的电池、发电机等的聚合信息。例如，单个组件 (多个电池) 也可以独立建模并与 UPS 相关联。

重要

DMTF (分布式管理任务组) CIM (Common Information Model) 类是生成 WMI 类的父类。 WMI 目前仅支持 CIM 2.x 版本架构。

以下语法从托管对象格式简化 (MOF) 代码，并包含其所有继承的属性。属性按字母顺序列出，而不是按 MOF 顺序列出。

语法

[Abstract, UUID("{8502C54F-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_UninterruptiblePowerSupply : CIM_PowerSupply
{
  uint16   ActiveInputVoltage;
  uint16   Availability;
  string   Caption;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  uint16   EstimatedChargeRemaining;
  uint32   EstimatedRunTime;
  datetime InstallDate;
  boolean  IsSwitchingSupply;
  uint32   LastErrorCode;
  string   Name;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  uint32   Range1InputFrequencyHigh;
  uint32   Range1InputFrequencyLow;
  uint32   Range1InputVoltageHigh;
  uint32   Range1InputVoltageLow;
  uint32   Range2InputFrequencyHigh;
  uint32   Range2InputFrequencyLow;
  uint32   Range2InputVoltageHigh;
  uint32   Range2InputVoltageLow;
  uint16   RemainingCapacityStatus;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TimeOnBackup;
  uint32   TotalOutputPower;
  uint16   TypeOfRangeSwitching;
};

成员

CIM_UninterruptiblePowerSupply 类具有以下类型的成员：

方法
属性

方法

CIM_UninterruptiblePowerSupply 类具有这些方法。

方法	说明
重置	请求重置逻辑设备。未由 WMI 实现。
SetPowerState	定义逻辑设备的所需电源状态，以及设备何时应进入该状态。未由 WMI 实现。

属性

CIM_UninterruptiblePowerSupply 类具有这些属性。

ActiveInputVoltage

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |电源|002.15“)

目前正在使用的电压范围。如果电源当前未通电，则可以指定值 6 (“Noter”) 。对于 UPS（ CIM_PowerSupply的子类），此信息是必需的。

此属性继承自 CIM_PowerSupply。

其他 (1)

未知 (2)

范围 1 (3)

范围 2 (4)

两 ( 5)

两 ( 6)

可用性

数据类型： 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)

设备安静。

Caption

数据类型： 字符串
访问类型：只读
限定符： MaxLen (64) 、 DisplayName (“Caption”)

对象的简短文本说明。

此属性继承自 CIM_ManagedSystemElement。

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

数据类型： 布尔值
访问类型：只读
限定符：架构 (“Win32”)

如果 为 TRUE，则设备正在使用用户定义的配置。

此属性继承自 CIM_LogicalDevice。

CreationClassName

数据类型： string
访问类型：只读
限定符： CIM_Key

创建实例时使用的类或子类的名称。与类的其他键属性一起使用时，此属性允许唯一标识类及其子类的所有实例。

此属性继承自 CIM_LogicalDevice。

描述

数据类型： string
访问类型：只读
限定符： DisplayName (“Description”)

对象的文本说明。

此属性继承自 CIM_ManagedSystemElement。

DeviceID

数据类型： string
访问类型：只读
限定符： CIM_Key

用于唯一命名逻辑设备的地址或其他标识信息。

此属性继承自 CIM_LogicalDevice。

ErrorCleared

数据类型： 布尔值
访问类型：只读

如果 为 TRUE，则现在清除 LastErrorCode 属性中报告的错误。

此属性继承自 CIM_LogicalDevice。

ErrorDescription

数据类型： string
访问类型：只读

自由格式字符串，提供有关 LastErrorCode 属性中记录的错误和要执行的纠正操作的信息。

此属性继承自 CIM_LogicalDevice。

EstimatedChargeRemaining

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |UPS 电池|001.4“) ，单位 (”百分比“)

使用电池技术的 UPS 剩余完整电量的百分比估计值。

EstimatedRunTime

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |UPS 电池|001.3“) ，单位 (”分钟“)

在当前负载条件下，电池、发电机或其他电源在当前负载条件下耗尽的估计时间（以分钟为单位），前提是公用电源已关闭，或者已丢失并保持关闭状态。

InstallDate

数据类型： datetime
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |ComponentID|001.5“) ， DisplayName (”安装日期“)

对象的安装日期和时间。此属性不需要值来指示已安装对象。

此属性继承自 CIM_ManagedSystemElement。

IsSwitchingSupply

数据类型： 布尔值
访问类型：只读

如果 为 TRUE，则电源是开关 (，而不是线性) 电源。

此属性继承自 CIM_PowerSupply。

LastErrorCode

数据类型： uint32
访问类型：只读

逻辑设备报告的最后一个错误代码。

此属性继承自 CIM_LogicalDevice。

名称

数据类型： 字符串
访问类型：只读
限定符： DisplayName (“Name”)

对象的已知标签。子类化后，可将此属性重写为键属性。

此属性继承自 CIM_ManagedSystemElement。

PNPDeviceID

数据类型： 字符串
访问类型：只读
限定符：架构 (“Win32”)

Win32 即插即用逻辑设备的设备标识符。此属性继承自 CIM_LogicalDevice。

示例：“*PNP030b”

PowerManagementCapabilities

数据类型： uint16 数组
访问类型：只读

逻辑设备的特定电源相关功能的数组。

此属性继承自 CIM_LogicalDevice。

未知 (0)

不支持 (1)

禁用 (2)

已启用 (3)

电源管理功能当前已启用，但确切功能集未知或信息不可用。

自动进入节能模式 (4)

设备可以根据使用情况或其他条件更改其电源状态。

Power State Settable (5)

支持 SetPowerState 方法。此方法在父 CIM_LogicalDevice 类上找到，可以实现。有关详细信息，请参阅设计托管对象格式 (MOF) 类。

支持电源循环 (6)

可以在 PowerState 参数设置为 5 的情况下调用 SetPowerState 方法， (Power Cycle) 。

支持计时开机 (7)

可以使用 PowerState 参数设置为 5 (Power Cycle) 和时间设置为开机的特定日期和时间或间隔来调用 SetPowerState 方法。

PowerManagementSupported

数据类型： 布尔值
访问类型：只读

如果 为 TRUE，则可以对设备进行电源管理，即进入省电状态。如果 为 FALSE，则整数值 1 (“Not Supported”) 应为 PowerManagementCapabilities 数组中的唯一条目。

此属性不指示当前是否已启用电源管理功能，如果已启用，则支持哪些功能。有关详细信息，请参阅 PowerManagementCapabilities 数组。此属性继承自 CIM_LogicalDevice。

Range1InputFrequencyHigh

数据类型： uint32
访问类型：只读
限定符：单位 (“hertz”)

频率，以Hz为单位，在电源的输入频率范围 1 的高端处。值为 0 (零) 表示 DC。

此属性继承自 CIM_PowerSupply。

Range1InputFrequencyLow

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |电源|002.17“) ，单位 (”hertz“)

频率，以Hz为单位，在电源输入频率范围 1 的低端处。值为 0 (零) 表示 DC。

此属性继承自 CIM_PowerSupply。

Range1InputVoltageHigh

数据类型： uint32
访问类型：只读
限定符：重写 (“Range1InputVoltageHigh”) ，单位 (“millivolts”)

如果电压（以毫伏为单位）高于 Range1InputVoltageHigh 属性指定的值，则 UPS 将通过修整电压进行补偿。值为 0 (零) 表示发生修整的电压未知。

此属性继承自 CIM_PowerSupply。

Range1InputVoltageLow

数据类型： uint32
访问类型：只读
限定符：重写 (“Range1InputVoltageLow”) ，单位 (“millivolts”)

如果电压（以毫伏为单位）低于 Range1InputVoltageLow 属性指定的值，则 UPS 将通过使用其电源提高电压进行补偿。值为 0 表示发生升压的电压未知。

此属性继承自 CIM_PowerSupply。

Range2InputFrequencyHigh

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |电源|002.20“) ，单位 (”hertz“)

频率（以Hz为单位），位于电源输入频率范围的高端 2。值为 0 (零) 表示 DC。

此属性继承自 CIM_PowerSupply。

Range2InputFrequencyLow

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |电源|002.19“) ，单位 (”hertz“)

频率，以Hz为单位，在电源输入频率范围 2 的低端。值为 0 表示 DC。

此属性继承自 CIM_PowerSupply。

Range2InputVoltageHigh

数据类型： uint32
访问类型：只读
限定符：替代 (“Range2InputVoltageHigh”) ，单位 (“millivolts”)

如果电压（以毫伏为单位）高于 Range2InputVoltageHigh 属性指定的值，则 UPS 将通过修整电压进行补偿。值为 0 (零) 表示发生修整的电压未知。

此属性继承自 CIM_PowerSupply。

Range2InputVoltageLow

数据类型： uint32
访问类型：只读
限定符：重写 (“Range2InputVoltageLow”) ，单位 (“millivolts”)

如果电压（以毫伏为单位）低于 Range2InputVoltageLow 属性指定的值，则 UPS 将通过使用其电源提升电压进行补偿。值为 0 (零) 表示发生升压的电压未知。

此属性继承自 CIM_PowerSupply。

RemainingCapacityStatus

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |UPS 电池|001.1“)

指示 UPS 电池、发电机或其他源中的剩余容量。

未知 (1)

正常 (2)

预计剩余的运行时间分钟数通常大于 UPS 定义的低功耗状态 (，) 为 2 分钟。

低 (3)

剩余的估计运行时间分钟数小于或等于 UPS 定义的低功耗状态。

耗尽 (4)

当公用电源丢失时，UPS 将无法维持当前负载， (包括公用电源当前可能缺电) 。

Status

数据类型： 字符串
访问类型：只读
限定符： MaxLen (10) 、 DisplayName (“Status”)

对象的当前状态。此属性继承自 CIM_ManagedSystemElement。

包括以下值：

OK (“OK”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

starting (“Starting”)

停止 (“停止”)

服务 (“服务”)

压力 (“有压力”)

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。Name“) ， CIM_Key

确定系统名称的范围。

此属性继承自 CIM_LogicalDevice。

TimeOnBackup

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |UPS 电池|001.2“) ，单位 (”秒“)

自 UPS 上次切换到电池电源、发电机或其他电源以来的经过时间（以秒为单位）。或者，自上次重启 UPS 以来的时间，以较少者为准。如果 UPS 处于联机状态，则将返回 0 (零) 。

TotalOutputPower

数据类型： uint32
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |电源|002.21“) ，单位 (”milliwatts“)

电源的总输出功率（以毫瓦为单位）。值为 0 (零) 表示未知。

此属性继承自 CIM_PowerSupply。

TypeOfRangeSwitching

数据类型： uint16
访问类型：只读
限定符： MappingStrings (“MIF”。DMTF |电源|002.16“)

在电源中实现的输入-电压范围切换的类型。

此属性继承自 CIM_PowerSupply。

其他 (1)

未知 (2)

手动 (3)

自动切换 (4)

宽范围 (5)

不适用 (6)

备注

CIM_UninterruptiblePowerSupply 类派生自 CIM_PowerSupply。

WMI 不实现此类。有关派生自 CIM_UninterruptiblePowerSupply 的 WMI 类，请参阅 Win32 类。

本文档派生自 DMTF 发布的 CIM 类说明。 Microsoft 可能已对更正小错误、符合 Microsoft SDK 文档标准或提供详细信息进行了更改。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另请参阅

CIM_PowerSupply

通过

CIM_UninterruptiblePowerSupply 类

语法

成员

方法

属性

备注

要求

另请参阅

反馈

其他资源