CIM_UninterruptiblePowerSupply クラス - WMI Library

CIM_UninterruptiblePowerSupply クラスの説明

無停電電源装置の機能と管理です。UPS デバイスのプロパティは、入力電力のトリミングや昇圧をいつ行うかと、デバイスを構成するバッテリやジェネレーターなど各種コンポーネントの集計情報を示します。また、これらのコンポーネント (複数のバッテリなど) は個別にモデル化して UPS に関連付けることも可能です。
UUIDは、{8502C54F-5FBB-11D2-AAC1-006008C78BC7}です。

---

プロパティ リスト

ActiveInputVoltage

Data Type: uint16

Access Type: Read Only

ActiveInputVoltage は、現在使用中の入力電圧範囲を示します。範囲 1 (値 = 3)、範囲 2 (値 = 4)、または両方 (値 = 5) を指定できます。この装置から現在電力が供給されていない場合は、値 6 ("どちらでもない") を指定できます。PowerSupply のサブクラスである UPS の場合はこの情報が必要です。

Availability

Data Type: uint16

Access Type: Read Only

デバイスの利用可能性と状態です。たとえば、Availability プロパティは、デバイスが実行中で通常の電力状態 (値 = 3) にあるか、警告 (4)、テスト中 (5)、低下 (10)、または省電力状態 (値 = 13-15 および 17) にあることを示します。省電力状態は次のように定義されています: 値 13 ("省電力 - 不明") は、デバイスが省電力モードになっていることは確かだが、省電力モードにおけるどの状態にあるかが不明であることを示します。値 14 ("省電力 - 低電力モード") は、デバイスが省電力状態になっているが機能しており、パフォーマンスは低下する場合があることを示します。値 15 ("省電力 - スタンバイ") は、デバイスが機能していないが、通常の電力での動作に 'すばやく' 移行できることを示します。値 17 ("省電力 - 警告") は、デバイスが警告状態になっているが、省電力モードでもあることを示します。

Caption

Data Type: string

Access Type: Read Only

Caption プロパティは、オブジェクトを短いテキスト (1 行の文字列) で表した説明です。

ConfigManagerErrorCode

Data Type: uint32

Access Type: Read Only

Win32 構成マネージャーのエラー コードを示します。次の値が返されます:
0 このデバイスは正常に動作しています。
1 このデバイスは正しく構成されていません。
2 このデバイスのドライバーを読み込めません。
3 このデバイスのドライバーは壊れているか、あるいはメモリまたは他のリソースが不足している状態でシステムが実行されている可能性があります。
4 このデバイスは正常に動作していません。ドライバーつまたはレジストリが壊れている可能性があります。
5 このデバイスのドライバーには Windows が管理できないリソースが必要です。
6 このデバイスのブート構成が他のデバイスと競合しています。
7 フィルター処理できません。
8 デバイスのドライバー ローダーが見つかりません。
9 このデバイスを制御するファームウェアからリソースが正しく報告されないため、このデバイスは正常に動作していません。
10 このデバイスを開始できません。
11 このデバイスはエラーで停止しました。
12 このデバイスで使用できる十分な空きリソースが見つかりません。
13 このデバイスのリソースを確認できません。
14 コンピューターを再起動するまでこのデバイスは正常に動作しません。
15 このデバイスは、再列挙に問題が発生している可能性があり、正常に動作していません。
16 このデバイスで使用される一部のリソースを認識できません。
17 このデバイスは不明なリソースの種類を要求しています。
18 このデバイスのドライバーを再インストールしてください。
19 レジストリが壊れている可能性があります。
20 VxD ローダーの使用に失敗しました。
21 システム エラー: このデバイスのドライバーを変更してみてください。うまくいかない場合はハードウェアのマニュアルを参照してください。このデバイスは削除されます。
22 このデバイスは無効になっています。
23 システム障害: このデバイスのドライバーを変更してみてください。うまくいかない場合はハードウェアのマニュアルを参照してください。
24 このデバイスは存在しないか、正常に動作していないか、または一部のドライバーがインストールされていません。
25 このデバイスはまだセットアップ処理中です。
26 このデバイスはまだセットアップ処理中です。
27 このデバイスに有効なログ構成がありません。
28 このデバイスのドライバーはインストールされていません。
29 このデバイスは、必要なリソースがデバイスのファームウェアから提供されなかったため無効になっています。
30 このデバイスは、他のデバイスが使用している割り込み要求 (IRQ) リソースを使用しています。
31 このデバイスは、このデバイスに必要なドライバーを読み込めないため正常に動作していません。

ConfigManagerUserConfig

Data Type: boolean

Access Type: Read Only

デバイスがユーザー定義の構成を使用しているかどうかを示します。

CreationClassName

Data Type: string

Access Type: Read Only

CreationClassName は、インスタンスの作成で使用されるクラス名、またはサブクラス名を示します。このクラスの他のキー プロパティと一緒に使用すると、このクラスおよびそのサブクラスのインスタンスすべてがこのプロパティによって一意に識別されます。

Description

Data Type: string

Access Type: Read Only

Description プロパティは、オブジェクトの説明を提供します。

DeviceID

Data Type: string

Access Type: Read Only

DeviceID は論理デバイスを一意に特定するためのアドレスまたは他の識別情報です。

ErrorCleared

Data Type: boolean

Access Type: Read Only

ErrorCleared は LastErrorCode プロパティで報告されたエラーが現在解決されているかどうかを示すブール値のプロパティです。

ErrorDescription

Data Type: string

Access Type: Read Only

ErrorDescription は、LastErrorCode プロパティに記録されたエラーに関する詳細情報およびそれに対する修正アクションに関する情報を提供する自由形式の文字列です。

EstimatedChargeRemaining

Data Type: uint16

Access Type: Read Only

UPS (バッテリを使用するもの) に残っている電力の、完全充電状態に対する概算パーセント数です。

EstimatedRunTime

Data Type: uint32

Access Type: Read Only

EstimatedRunTime は、外部電源の供給がオフまたは停電状態になっているか、ラップトップが電源につながっていない場合、現在の負荷状態で予想されるバッテリの放電持続時間 (分) です。

InstallDate

Data Type: datetime

Access Type: Read Only

InstallDate プロパティは、オブジェクトがいつインストールされたかを示す datetime 値です。値がなくても、オブジェクトがインストールされていないことを示すわけではありません。

IsSwitchingSupply

Data Type: boolean

Access Type: Read Only

電源装置がスイッチング電源である (リニア電源ではない) ことを示すブール値です。

LastErrorCode

Data Type: uint32

Access Type: Read Only

LastErrorCode には、その論理デバイスで最後に報告されたエラー コードが記録されています。

Name

Data Type: string

Access Type: Read Only

Name プロパティは、オブジェクトを認識するためのラベルを定義します。サブクラスでは、Name プロパティは上書きされて Key プロパティになることがあります。

PNPDeviceID

Data Type: string

Access Type: Read Only

論理デバイスの Win32 プラグ アンド プレイ デバイス ID を示します。例: *PNP030b

PowerManagementCapabilities

Data Type: uint16

Access Type: Read Only

論理デバイスの具体的な電源関連機能を示します。0="不明"、1="サポートされていません"、および 2="無効" は文字どおりの意味です。3="有効" は、電源管理機能は現在有効であるが、正確な機能セットが不明か、または情報を取得できないことを示します。"自動省電力モード" (4) は、使用状況または他の条件に基づいてデバイスが電源の状態を変更できることを示します。"電源の状態設定可能" (5) は、SetPowerState メソッドがサポートされていることを示します。"電源サイクル サポート" (6) は、SetPowerState メソッドの PowerState 入力変数に 5 ("電源サイクル") を設定して呼び出せることを示します。"時刻指定電源オン サポート" (7) は、SetPowerState メソッドの PowerState 入力変数に 5 ("電源サイクル") を設定し、Time パラメーターに電源オンの具体的な日時または時間間隔を設定して呼び出せることを示します。

PowerManagementSupported

Data Type: boolean

Access Type: Read Only

デバイスの電源管理が可能である (省電力状態に移行できる) ことを示すブール値です。電源管理機能が現在有効であるかどうかや、有効である場合にどの機能がサポートされるかを示す値ではありません。そうした情報については PowerManagementCapabilities 配列を参照する必要があります。このブール値が false の場合、PowerManagementCapabilities 配列には、文字列 "サポートされていません" を示す整数値 1 のエントリだけが含まれます。

Range1InputFrequencyHigh

Data Type: uint32

Access Type: Read Only

この電源の入力周波数範囲 1 の上限における周波数です (ヘルツ)。値 0 は DC を示します。

Range1InputFrequencyLow

Data Type: uint32

Access Type: Read Only

この電源の入力周波数範囲 1 の下限における周波数です (ヘルツ)。値 0 は DC を示します。

Range1InputVoltageHigh

Data Type: uint32

Access Type: Read Only

電圧 (ミリボルト) が Range1InputVoltageHigh プロパティによって指定された値以上に上がると、UPS は、トリミングによって電圧の上昇を補正します。値 0 は、電圧がどのような値になったときにトリミングを行うかが '不明' であることを示します。

Range1InputVoltageLow

Data Type: uint32

Access Type: Read Only

電圧 (ミリボルト) が Range1InputVoltageLow プロパティによって指定された値以下に落ちると、UPS は、UPS の電源を使用して昇圧することにより電圧の低下を補正します。値 0 は、電圧がどのような値になったときに昇圧を行うかが '不明' であることを示します。

Range2InputFrequencyHigh

Data Type: uint32

Access Type: Read Only

この電源の入力周波数範囲 2 の上限における周波数です (ヘルツ)。値 0 は DC を示します。

Range2InputFrequencyLow

Data Type: uint32

Access Type: Read Only

この電源の入力周波数範囲 2 の下限における周波数です (ヘルツ)。値 0 は DC を示します。

Range2InputVoltageHigh

Data Type: uint32

Access Type: Read Only

電圧 (ミリボルト) が Range2InputVoltageHigh プロパティによって指定された値以上に上がると、UPS は、トリミングによって電圧の上昇を補正します。値 0 は、電圧がどのような値になったときにトリミングを行うかが '不明' であることを示します。

Range2InputVoltageLow

Data Type: uint32

Access Type: Read Only

電圧 (ミリボルト) が Range2InputVoltageLow プロパティによって指定された値以下に落ちると、UPS は、UPS の電源を使用して昇圧することにより電圧の低下を補正します。値 0 は、電圧がどのような値になったときに昇圧を行うかが '不明' であることを示します。

RemainingCapacityStatus

Data Type: uint16

Access Type: Read Only

UPS バッテリ、ジェネレーターなどの残存容量の表示です。値 "通常" (2) は、予想される残り稼働時間 (分) が UPS で定義された '低電力' 状態 (通常 2 分) より長いことを示します。値 "低" (3) は、予想される残り稼働時間 (分) が UPS で定義された '低電力' 状態以下であることを示します。値 "消耗" (4) は、外部電源の供給が止まった場合 (外部電源が現在存在しない場合も含む)、UPS は現在の負荷に対応できないことを示します。

Status

Data Type: string

Access Type: Read Only

Status プロパティはオブジェクトの現在の状態を示す文字列です。操作可能な状態および操作不可能な状態が定義されます。操作可能な状態は、"OK"、"低下" および "障害が発生する可能性あり" です。"障害が発生する可能性あり" は、要素は適切に機能するけれども近いうちに障害が発生する可能性があることを示します。例: SMART 対応ハード ディスク。操作不可能な状態も指定できます。これは、"エラー"、"開始中"、"停止動作中" および "サービス" です。最後の "サービス" には、ディスクがミラーされている間、ユーザーのアクセス許可の一覧を再度読み込む間、または他の管理用作業が行われている間などが該当します。この作業がすべてオンラインで行われるとは限りませんが、[管理要素] は "OK" でも他の状態でもありません。

StatusInfo

Data Type: uint16

Access Type: Read Only

StatusInfo は、論理デバイスが有効 (値 = 3)、無効 (値 = 4)、その他の状態 (1) または不明な状態 (2) であることを示す文字列です。このプロパティが論理デバイスに適用されない場合は、値 5 ("該当なし") が使用されます。

SystemCreationClassName

Data Type: string

Access Type: Read Only

スコーピング システムの CreationClassName です。

SystemName

Data Type: string

Access Type: Read Only

スコーピング システムの名前です。

TimeOnBackup

Data Type: uint32

Access Type: Read Only

TimeOnBackup は、UPS がバッテリ電源に最後に切り替わったときからの経過時間 (秒) か、UPS が最後に再起動したときからの経過時間のうち、小さい値を示します。バッテリが 'オン ライン' の場合は 0 を返します。

TotalOutputPower

Data Type: uint32

Access Type: Read Only

電源装置の合計出力電力を表します (ミリワット)。値 0 は不明を示します。

TypeOfRangeSwitching

Data Type: uint16

Access Type: Read Only

TypeOfRangeSwitching は、この電源装置に実装されている入力電圧範囲切り替えの種類を示します。たとえば、自動スイッチ (値 = 4) を指定することができます。

---

メソッド リスト

SetPowerState

SetPowerState は、論理デバイスに対して希望する電源状態と、デバイスをいつその状態にするかを定義します。電源状態は、1="通常の電力"、2="省電力 - 低電力モード"、3="省電力 - スタンバイ"、4="省電力 - その他"、5="電源サイクル" または 6="電源オフ" のいずれかの整数値を PowerState パラメーターに設定することで指定します。Time パラメーターには、(5 の "電源サイクル" を除くすべての状態変更について) 電源状態を設定するときを示す標準の日付時刻値または間隔値 (メソッド呼び出しが受信された時点からの経過時間) を指定します。PowerState パラメーターが 5 の "電源サイクル" の場合、Time パラメーターには、システムをもう一度電源オンにするときを指定します。電源オフは直ちに実行されます。SetPowerState は、成功した場合は 0 を返し、指定した PowerState および要求時間がサポートされていない場合は 1 を返し、その他のエラーが発生した場合は別の値を返します。サブクラスでは、メソッドに ValueMap 修飾子を使用して可能なリターン コードのセットを指定できる場合があります。また、サブクラスでは、ValueMap の内容を '翻訳' した文字列を Values 配列修飾子として指定できる場合があります。

Reset

論理デバイスのリセットを要求します。要求が正常に実行された場合、返される値は 0 で、要求がサポートされない場合は 1 です。また、エラーが発生した場合は他の値となります。

---

WQL サンプル

SELECT * FROM CIM_UninterruptiblePowerSupply

VB6/VBS
SWbemServicesクラスのExecQueryメソッドからWQLを実行可能です。
Set PrcSet = Service.ExecQuery("SELECT * FROM CIM_UninterruptiblePowerSupply")

VB.Net
ObjectQueryクラスのQueryStringプロパティにWQLを設定し、ManagementObjectSearcherクラスのGetメソッドからWQLを実行可能です。
Searcher.Query.QueryString = "SELECT * FROM CIM_UninterruptiblePowerSupply"
PrcSrc = Searcher.Get

PowerShell
Get-WmiObjectコマンドレットのqueryオプションを指定しWQLを実行可能です。
Get-WmiObject -query "SELECT * FROM CIM_UninterruptiblePowerSupply"

---

このサイトの情報について

このコンテンツはWMIの各コンポーネントが持っているCIM_UninterruptiblePowerSupplyクラス情報を参照・抽出しリファレンスとして作成・提供しています。
参照したWMIの名前空間はroot/CIMV2、書き出し環境はWindows Server 2008 R2になります。

WMIの使い方(VB6, VBS, VBA, VB.NET, VC#, PowerShellを対象)に関してはWMI Stepも参考にしてみてください。(WMI初心者・入門編としてもおすすめです。) 各種言語を使用したWMIを使用するたたき台としてソーステンプレートも公開しています。プログラム/スクリプト作成時に役立てば…と思っています。

今後各WMI ClassをサポートしているOSの種類を掲載する予定です。
予定OS: Windows XP/Windows Vista/Windows 7/Windows Server 2003/Windows Server 2003 R2/Windows Server 2008/Windows Server 2008 R2

---