Intel AMT Features > Remote Control > Use Cases > Set or Disable Boot Configuration Settings for the Next Boot
CollapseAll image

Set or Disable Boot Configuration Settings for the Next Boot

The following steps describe how to set or disable an existing CIM_BootConfigSetting to be used on next boot. This flow assumes there is a retrieved CIM_BootConfigSetting instance, referred to as “boot configuration”. See Retrieve the Boot Configuration Settings.

1.  Retrieve the CIM_BootService instance, where the “Name” key equals “Intel(r) AMT Boot Service”.

2.  Invoke SetBootConfigRole from the retrieved CIM_BootService with the following fields:

Parameter

Value

BootConfigSetting

The “boot configuration” reference

Role

Either “IsNextSingleUse” (1), or “IsNotNext” (32768)

“IsNextSingleUse” designates this instance as the configuration for the next  boot. “IsNotNext” disables this instance. The next boot will use the default configuration instead.

The “IsNextSingleUse” (1) flag is removed after the next boot and reverts to “IsNotNext” (32768).

 

Click here for a snippet demonstrating this step

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

  

$bootServiceRef = $wsmanConnectionObject.NewReference("SELECT * FROM CIM_BootService WHERE Name='Intel(r) AMT Boot Service'")

$inputObject = $bootServiceRef.CreateMethodInput("SetBootConfigRole")

$inputObject.SetProperty("BootConfigSetting", $bootConfigSettingRef)

$inputObject.SetProperty("Role", "1")

$outputObject = $bootServiceRef.InvokeMethod($inputObject)

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

 

 

Additional Information

Intel AMT supports only “IsNextSingleUse” and “IsNotNext” (since Release 7.0) for the role field.

For Intel AMT 6.0 this function may fail if some fields of AMT_BootSettingData (associate to the “boot configuration”) are set to true and a boot source is set for the “boot configuration”. See Additional Information in the Set SOL/IDE-R and other Boot Options use case.

After the next boot, the AMT_BootSettingData  settings will persist while the CIM_BootService  role “IsNextSingleUse” (1) flag will be removed. The association between AMT_BootSettingData and CIM_BootSourceSetting via the CIM_OrderedComponent “AssignedSequence” property will reset to “0”.

Instance Diagram

Classes Used in This Flow

SDK Sample

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

 

See Also:

   Boot Control

   Boot Configuration Details

 

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