WS-Management > WS-Management Class Reference > CIM Classes > CIM_PowerManagementCapabilities

Class CIM_PowerManagementCapabilities

Used in features: Remote Control
Compatible with the following Intel AMT Releases: 3.0, 3.2, 4.0, 5.0, 5.1, 6.0, 6.1, 6.2, 7.0, 8.0, 8.1, 9.0, 9.5
CIM_ManagedElement
   extended by CIM_Capabilities
      extended by CIM_PowerManagementCapabilities

Also see:
AMT_BootCapabilities

class CIM_PowerManagementCapabilities
extends CIM_Capabilities

General Information:
A class derived from Capabilities that describes the power management aspects of an element (typically a system or device). The element's power management capabilities are decoupled from a PowerManagementService, since a single service could apply to multiple elements, each with specific capabilities.

Qualifiers:
-------------
Version=2.23.0
UMLPackagePath=CIM::Core::PowerMgmt


Supported Fields Summary
 string ElementName
The user friendly name for this instance of Capabilities . . .
 string InstanceID Key
Within the scope of the instantiating Namespace, InstanceID opaquely and uniquely identifies an instance of this class . . .
 uint16[10] PowerStatesSupported
An enumeration that indicates the power states supported by a managed element . . .
 uint16[7] PowerChangeCapabilities
An enumeration indicating the specific power-related capabilities of a managed element . . .
 string OtherPowerChangeCapabilities
A string describing the additional power management capabilities of the element, used when the PowerChangeCapabilities is set to the value 1, "Other".
 uint16[] RequestedPowerStatesSupported
An enumeration that indicates the requested power states supported by the power management service . . .

Methods Summary
  Put(Instance)
Changes properties of the selected instance
  Get(Instance)
Gets the representation of the instance
  Pull(EnumerationContext, MaxElements)
Pulls instances of this class, following an Enumerate operation
  Enumerate()
Enumerates the instances of this class
  Release(EnumerationContext)
Releases an enumeration context

Field Detail

ElementName

public string ElementName
General Information:
The user friendly name for this instance of Capabilities. In addition, the user friendly name can be used as a index property for a search of query. (Note: Name does not have to be unique within a namespace.)

Product Specific Usage:
In Intel AMT Release 6.0 and later releases value is "Power Management Capabilities"

Qualifiers:
-------------
Required
Override=ElementName
MaxLen=30


InstanceID Key

public string InstanceID
General Information:
Within the scope of the instantiating Namespace, InstanceID opaquely and uniquely identifies an instance of this class. In order to ensure uniqueness within the NameSpace, the value of InstanceID SHOULD be constructed using the following 'preferred' algorithm:
<OrgID>:<LocalID>
Where <OrgID> and <LocalID> are separated by a colon ':', and where <OrgID> MUST include a copyrighted, trademarked or otherwise unique name that is owned by the business entity creating/defining the InstanceID, or is a registered ID that is assigned to the business entity by a recognized global authority (This is similar to the <Schema Name>_<Class Name> structure of Schema class names.) In addition, to ensure uniqueness <OrgID> MUST NOT contain a colon (':'). When using this algorithm, the first colon to appear in InstanceID MUST appear between <OrgID> and <LocalID>.
<LocalID> is chosen by the business entity and SHOULD not be re-used to identify different underlying (real-world) elements. If the above 'preferred' algorithm is not used, the defining entity MUST assure that the resultant InstanceID is not re-used across any InstanceIDs produced by this or other providers for this instance's NameSpace.
For DMTF defined instances, the 'preferred' algorithm MUST be used with the <OrgID> set to 'CIM'.

Product Specific Usage:
In Intel AMT Release 6.0 and later releases value is "Intel(r) AMT:PowerManagementCapabilities 0"

Qualifiers:
-------------
Key
Override=InstanceID
MaxLen=50


PowerStatesSupported

public uint16[10] PowerStatesSupported
General Information:
An enumeration that indicates the power states supported by a managed element. Because this is an array, multiple values can be specified. The current values in the enumeration are:
2=On, corresponding to ACPI state G0 or S0 or D0.
3=Sleep - Light, corresponding to ACPI state G1, S1/S2, or D1.
4=Sleep - Deep, corresponding to ACPI state G1, S3, or D2.
5=Power Cycle (Off - Soft), corresponding to ACPI state G2, S5, or D3, but where the managed element is set to return to power state "On" at a pre-determined time.
6=Off - Hard, corresponding to ACPI state G3, S5, or D3.
7=Hibernate (Off - Soft), corresponding to ACPI state S4, where the state of the managed element is preserved and will be recovered upon powering on.
8=Off - Soft, corresponding to ACPI state G2, S5, or D3.
9= Power Cycle (Off-Hard), corresponds to the managed element reaching the ACPI state G3 followed by ACPI state S0.
10=Master Bus Reset, corresponds to the system reaching ACPI state S5 followed by ACPI state S0. This is used to represent system master bus reset.
11=Diagnostic Interrupt (NMI), corresponding to the system reaching ACPI state S5 followed by ACPI state S0. This is used to represent system non-maskable interrupt.
12=Off - Soft Graceful, equivalent to Off Soft but preceded by a request to the managed element to perform an orderlyshutdown.
13=Off - Hard Graceful, equivalent to Off Hard but preceded by a request to the managed element to perform an orderly shutdown.
14=Master Bus Rest Graceful, equivalent to Master Bus Reset but preceded by a request to the managed element to perform an orderly shutdown.
15=Power Cycle (Off - Soft Graceful), equivalent to Power Cycle (Off - Soft) but preceded by a request to the managed element to perform an orderly shutdown.
16=Power Cycle (Off - Hard Graceful), equivalent to Power Cycle (Off - Hard) but preceded by a request to the managed element to perform an orderly shutdown.
..=DMTF Reserved.
0x7FFF..0xFFFF = Vendor Specific.

Qualifiers:
-------------
ValueMap={1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, .., 0x7FFF..0xFFFF}
Values={Other, On, Sleep - Light, Sleep -Deep, Power Cycle (Off - Soft), Off - Hard, Hibernate (Off - Soft), Off - Soft, Power Cycle (Off-Hard), Master Bus Reset, Diagnostic Interrupt (NMI), Off - Soft Graceful, Off - Hard Graceful, Master Bus Reset Graceful, Power Cycle (Off - Soft Graceful), Power Cycle (Off - Hard Graceful), DMTF Reserved, Vendor Specific}
MappingStrings={IEEE P1621 | 3.2}
ModelCorrespondence={CIM_PowerManagementService.RequestPowerStateChange, CIM_AssociatedPowerManagementService.PowerState}


PowerChangeCapabilities

public uint16[7] PowerChangeCapabilities
General Information:
An enumeration indicating the specific power-related capabilities of a managed element. Since this is an array, multiple values may be specified. The current values in the enumeration are:
0 = Unknown
1 = Other
2 = Power Saving Modes Entered Automatically, describing that a managed element can change its power state based on usage or other criteria
3 = Power State Settable, indicating that the RequestPowerStateChange method is supported
4 = Power Cycling Supported, indicating that the RequestPowerStateChange method can be invoked with the PowerState input variable set to 'Power Cycle (Off Soft)'
5 = Timed Power On Supported, indicating that the RequestPowerStateChange method can be invoked with the PowerState input variable set to 'Power On' and the Time parameter set to a specific date and time, or interval, for power-on.8 = Graceful Shutdown Supported, indicating that the managed element can be sent a hardware signal requesting an orderly shutdown prior to the requested power state change.

Qualifiers:
-------------
ValueMap={0, 1, 2, 3, 4, 5, 6, 7, 8}
Values={Unknown, Other, Power Saving Modes Entered Automatically, Power State Settable, Power Cycling Supported, Timed Power On Supported, Off Hard Power Cycling Supported, HW Reset Supported, Graceful Shutdown Supported}
ModelCorrespondence={CIM_PowerManagementService.RequestPowerStateChange, CIM_PowerManagementCapabilities.OtherPowerChangeCapabilities}


OtherPowerChangeCapabilities

public string OtherPowerChangeCapabilities
General Information:
A string describing the additional power management capabilities of the element, used when the PowerChangeCapabilities is set to the value 1, "Other".

Qualifiers:
-------------
ModelCorrespondence={CIM_PowerManagementCapabilities.PowerChangeCapabilities}
MaxLen=256


RequestedPowerStatesSupported

public uint16[] RequestedPowerStatesSupported
General Information:
An enumeration that indicates the requested power states supported by the power management service. Because this is an array, multiple values can be specified. The current values in the enumeration are:
2=On, corresponding to ACPI state G0 or S0 or D0.
3=Sleep - Light, corresponding to ACPI state G1, S1/S2, or D1.
4=Sleep - Deep, corresponding to ACPI state G1, S3, or D2.
5=Power Cycle (Off - Soft), corresponding to ACPI state G2, S5, or D3, but where the managed element is set to return to power state "On" at a pre-determined time.
6=Off - Hard, corresponding to ACPI state G3, S5, or D3.
7=Hibernate (Off - Soft), corresponding to ACPI state S4, where the state of the managed element is preserved and will be recovered upon powering on.
8=Off - Soft, corresponding to ACPI state G2, S5, or D3. 9= Power Cycle (Off-Hard), corresponds to the managed element reaching the ACPI state G3 followed by ACPI state S0.
10=Master Bus Reset, corresponds to the system reaching ACPI state S5 followed by ACPI state S0. This is used to represent system master bus reset. 11=Diagnostic Interrupt (NMI), corresponding to the system reaching ACPI state S5 followed by ACPI state S0. This is used to represent system non-maskable interrupt. 12=Off - Soft Graceful, equivalent to Off Soft but preceded by a request to the managed element to perform an orderlyshutdown.
13=Off - Hard Graceful, equivalent to Off Hard but preceded by a request to the managed element to perform an orderly shutdown.
14=Master Bus Rest Graceful, equivalent to Master Bus Reset but preceded by a request to the managed element to perform an orderly shutdown.
15=Power Cycle (Off - Soft Graceful), equivalent to Power Cycle (Off - Soft) but preceded by a request to the managed element to perform an orderly shutdown.
16=Power Cycle (Off - Hard Graceful), equivalent to Power Cycle (Off - Hard) but preceded by a request to the managed element to perform an orderly shutdown.
17=Diagnostic Interrupt (INIT), equivalent to Diagnostic Interrupt (NMI) but performed by an INIT switch instead because the NMI signal is masked.
..=DMTF Reserved.
0x7FFF..0xFFFF = Vendor Specific.

Qualifiers:
-------------
ValueMap={1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, .., 0x7FFF..0xFFFF}
Values={Other, On, Sleep - Light, Sleep -Deep, Power Cycle (Off - Soft), Off - Hard, Hibernate (Off - Soft), Off - Soft, Power Cycle (Off-Hard), Master Bus Reset, Diagnostic Interrupt (NMI), Off - Soft Graceful, Off - Hard Graceful, Master Bus Reset Graceful, Power Cycle (Off - Soft Graceful), Power Cycle (Off - Hard Graceful), Diagnostic Interrupt (INIT), DMTF Reserved, Vendor Specific}
MappingStrings={IEEE P1621 | 3.2}
ModelCorrespondence={CIM_PowerManagementCapabilities.PowerStatesSupported, CIM_PowerManagementService.RequestPowerStateChange, CIM_AssociatedPowerManagementService.PowerState}


Method Detail

Put

public  Put([IN]CIM_PowerManagementCapabilities Instance)
Permission Information:
Permitted realms: ADMIN_SECURITY_REMOTE_CONTROL_REALM, ADMIN_SECURITY_LOCAL_SYSTEM_REALM

General Information:
Changes properties of the selected instance

Product Specific Usage:
The following properties must be included in any representation of CIM_PowerManagementCapabilities:

ElementName
InstanceID


Get

public  Get([OUT]CIM_PowerManagementCapabilities Instance)
Permission Information:
Permitted realms: ADMIN_SECURITY_REMOTE_CONTROL_REALM, ADMIN_SECURITY_GENERAL_INFO_REALM

General Information:
Gets the representation of the instance

Pull

public  Pull([IN]String EnumerationContext, [IN]String MaxElements)
Permission Information:
All users permitted to use method, only instances to whom the user has permissions will be returned

General Information:
Pulls instances of this class, following an Enumerate operation

Enumerate

public  Enumerate()
Permission Information:
All users permitted to use method

General Information:
Enumerates the instances of this class

Release

public  Release([IN]String EnumerationContext)
Permission Information:
All users permitted to use method

General Information:
Releases an enumeration context

Copyright © 2006-2013, Intel Corporation. All rights reserved.