Intel AMT Features > Remote Control > Use Cases > Get Boot Details for a Boot Configuration Setting Instance
CollapseAll image

Get Boot Details for a Boot Configuration Setting Instance

The following steps describe how to retrieve boot setting details of a specific boot configuration setting.

Boot details refer to the boot devices, represented as CIM_BootSourceSetting, and the configuration setting of the boot, represented as AMT_BootSettingData.

1.  Retrieve the instance of CIM_BootConfigSetting (see Retrieve the Boot Configuration Settings). This instance will be referred to as the “boot configuration”.

2.  Determine which boot source, if any, is set in the “boot configuration”.

a.   Retrieve the CIM_OrderedComponent using enumerate with association filter using association instance with the following parameters:        

Parameter

Value

Object

The retrieved “boot configuration” reference

Result Class Name

CIM_OrderedComponent

Role

GroupComponent

b.  For each instance of CIM_OrderedComponent found in step a, check that the property “PartComponent” holds a reference to CIM_BootSourceSetting.

c.  For each of the components that meet the condition in step b, check the field “AssignedSequence”. The order that the boot sources will be used is lowest first, starting with “1” when boot sources with “AssignedSequence” of zero will not be used.

d.  Retrieve the boot source using the reference in the PartComponent field. The possible values are hard-drive boot, CD/DVD boot, Diagnostic boot (removed in Release 7.0), and PXE boot.

Click here for a snippet demonstrating this step

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

  

# Create a reference to the CIM_BootConfigSetting instance.

$bootConfigSettingRef =$wsmanConnectionObject.NewReference("SELECT * FROM CIM_BootConfigSetting WHERE InstanceID='Intel(r) AMT: Boot Configuration 0'")

$orderedComponentRef =$wsmanConnectionObject.NewReference("CIM_OrderedComponent")

$orderedComponentRef.AddSelector("GroupComponent",$bootConfigSettingRef)

# Traverse to the CIM_OrderedComponent instances that are connected to the CIM_BootConfigSetting.

foreach($orderedComponentItem in$orderedComponentRef.Enumerate("http://schemas.dmtf.org/wbem/wsman/1/wsman/SelectorFilter",$null))

{

    # For each instance, check if it is associated to the CIM_BootSourceSetting instance.

if($orderedComponentItem.Object.GetProperty("PartComponent").IsA("CIM_BootSourceSetting"))

    {

          $assignedSequence =$orderedComponentItem.Object.GetProperty("AssignedSequence")

          if ($assignedSequence -like "1")

          {

                # Get the CIM_BootSourceSetting object using its EPR.

                $bootSourceSettingInstance =$orderedComponentItem.Object.GetProperty("PartComponent").Ref.Get()

                $instanceID =$bootSourceSettingInstance.GetProperty("InstanceID")

                break

          }

    }

}

 

 

3.  Retrieve the instance of AMT_BootSettingData, where the ”InstanceID” key equals 'Intel(r) AMT:BootSettingData 0'. The retrieved AMT_BootSettingData instance holds details about the configuration boot.

Click here for a snippet demonstrating this step

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

  

$bootSettingDataRef =$wsmanConnectionObject.NewReference("SELECT * FROM AMT_BootSettingData WHERE InstanceID='Intel(r) AMT:BootSettingData 0'")

$bootSettingDataInstance =$bootSettingDataRef.Get()

$BIOSPause =$bootSettingDataInstance.GetProperty("BIOSPause")

 

 

Additional Information

AMT_BootSettingData is an Intel AMT unique class that inherits from CIM_BootSettingData and presents the boot details and options.

Instance Diagram

Classes Used in This Flow

SDK Sample

If there is a sample demonstrating this flow, it is included in the SDK installation file. See SDK Installation Layout for details.

 

See Also:

   Boot Control

   Boot Configuration Details

 

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