Intel AMT Features > Alarm Clock > Use Cases > Set the Alarm Clock to Activate at Defined Intervals
CollapseAll image

Set the Alarm Clock to Activate at Defined Intervals

The following steps describe how to set the alarm clock to activate at a pre-defined interval. The wake–up mechanism performs the equivalent of a remote control power up command.

1.  Retrieve the instance of AMT_AlarmClockService, where the “Name” key equals “Intel(r) AMT Alarm Clock Service”.

2.  Set AMT_AlarmClockService.NextAMTAlarmTime to the first time when Intel AMT should turn on the host.

 Note:

The value of the NextAMTAlarmTime Datetime format requires a “T” between the date and the time and must end with “Z”. Seconds must be set to zero. For example: "yyyy-mm-ddThh:mm:00Z". The time must be later than the current time or the Set operation will be rejected.

3.  Set AMT_AlarmClockService.AMTAlarmClockInterval to a valid value.

 Note:

The AMTAlarmClockInterval format is PdDThHmM:

   There must be a P even if there is no hours setting. For example, P1D represents 1 day.

   The d value after the P is integer days. h and m after the T are integer hours and minutes. Valid hours are 0 to 23. Valid minutes are 0 to 59. Invalid values are rejected.

For example:

   To define a one-day interval: “P1D”

   To define an interval of three hours: “PT3H”

   To define an interval of approximately one year, one month and three hours: “P395DT3H”

4.  Set the values by sending AMT_AlarmClockService.Put.

Click here for a snippet demonstrating this step

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

  

# Create the XML format of the NextAMTAlarmClock and the AMTAlarmClockInterval properties. 

$nextAlarmTime =  $wsmanConnectionObject.NewInstance("Datetime")

$nextAlarmTime.Text ="2013-11-07T16:28:00Z"

$amtAlarmClockInterval =$wsmanConnectionObject.NewInstance("Interval")

$amtAlarmClockInterval.Text ="P1D"

$alarmClockServiceRef =$wsmanConnectionObject.NewReference("SELECT * FROM AMT_AlarmClockService WHERE Name='Intel(r) AMT Alarm Clock Service'")

$alarmClockServiceInstance =$alarmClockServiceRef.Get()

$alarmClockServiceInstance.SetProperty("NextAMTAlarmTime",$nextAlarmTime)

$alarmClockServiceInstance.SetProperty("AMTAlarmClockInterval",$amtAlarmClockInterval)

$alarmClockServiceRef.Put($alarmClockServiceInstance)

 

 

Additional Information

The XML representation of the property NextAMTAlarmTime should be in Datetime format or in Interval format, as defined in the WS-CIM Mapping Specification (DSP0230). The following examples are XML representations of these formats.

<NextAMTAlarmTime>

  <Datetime xmlns="http://schemas.dmtf.org/wbem/wscim/1/common">…</Datetime>

<NextAMTAlarmTime>

 

<AMTAlarmClockInterval>

  <Interval xmlns="http://schemas.dmtf.org/wbem/wscim/1/common">…</Interval>

</AMTAlarmClockInterval>

 

Instance Diagram

Classes Used in This Flow

SDK Sample

Located at:<SDK_root>\Windows\Intel_AMT\Samples\WS-Management\AlarmClock\c#

 

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