Intel AMT Features > Remote Control > Use Cases > Change System Power State
CollapseAll image

Change System Power State

The following steps describe how to change the power state of the platform. This section follows the approach of section 9.5 of DSP1027.

 Note:

   If there is an active redirection session (SOL, IDE-R or KVM), then a power cycle or a power off command will be rejected as invalid. See Intel AMT Power State Transitions.

   Do not request a second power state change without allowing the first request to complete. Completion in this case is defined as allowing the BIOS to inform Intel AMT that it has completed its tasks. This can take as much as 10 seconds, depending on the OEM platform.

 

1.  Retrieve the instance of CIM_PowerManagementService, using the “Name” key equal to “Intel(r) AMT Power Management Service”.

2.  Invoke CIM_PowerManagementService.RequestPowerStateChange using the following parameters:

Parameter

Value

Power State

One of the defined power states

Managed Element

A reference to the “managed system” object

Time

NULL

TimeoutPeriod

NULL

The following table lists all possible system power states and those states which are able to be changed.

Power State ValueMap

Value

Pre-9.0

9.0

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.

 

 

Click here for a snippet demonstrating this step

You can execute this snippet by inserting it into the execution template found here.

  

$powerManagementRef = $wsmanConnectionObject.NewReference("SELECT * FROM CIM_PowerManagementService WHERE Name='Intel(r) AMT Power Management Service'")

$inputObject = $powerManagementRef.CreateMethodInput("RequestPowerStateChange")

$inputObject.SetProperty("PowerState", "5") # '5' = SoftPowerCycle.

$computerSystemRef = $wsmanConnectionObject.NewReference("SELECT * FROM CIM_ComputerSystem WHERE Name='ManagedSystem'")

$inputObject.SetProperty("ManagedElement", $computerSystemRef)

$outputObject = $powerManagementRef.InvokeMethod($inputObject)

$returnValue = $outputObject.GetProperty("ReturnValue")

 

 

 

 Note:

The method CIM_PowerManagementService.RequestPowerStateChange is blocked locally and is only available to remote users. (It was available locally only in Release 6.1)

 

Additional Information

The Power State must one supported by the platform (see Get System Power Management Capabilities ). The transition must be valid from the current power state (see Intel AMT Power State Transitions ).

As of Release 6.0, Intel AMT does not support the Time and Timeout fields.

Instance Diagram

Classes Used in This Flow

SDK Sample

Located at:<SDK_root>\Windows\Intel_AMT\Samples\WS-Management\RemoteControl

 

See Also:

   Supported Power Management States

   Intel AMT Power State Transitions

   DSP1027 section7.3.1 Power State values

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