Setup and Configuration of Intel AMT > Configuration Settings > Network Administration > Use Cases > Set /Get Miscellaneous Network Interface Settings
CollapseAll image

Set /Get Miscellaneous Network Interface Settings

Intel AMT has a wired interface, and a wireless interface in certain platforms. Beginning from Release 9.5, some platforms have no wired interface.  Each interface is represented by a CIM_EthernetPort instance and is configured with different network settings. The following steps describe how to manipulate per-interface miscellaneous network settings, not described in the other use cases.

1.  Retrieve the instance of AMT_EthernetPortSettings, where the “InstanceID” key equals “Intel(r) AMT Ethernet Port Settings 0” (wired interface) or “Intel(r) AMT Ethernet Port Settings 1” (wireless interface).

2.  Retrieve or configure various settings (using the Get or Put methods) defined in the following properties of AMT_EthernetPortSettings:

Property

Value

VLANTag

Indicates whether VLAN is in use and what is the VLAN tag when used

SharedMAC

Indicates whether Intel(R) AMT shares its MAC address with the host system. This property is only visible / usable for users of ADMIN_SECURITY_ADMINISTRATION realm. Additional Note: This is a required property in Intel AMT Release 3.0 and Intel AMT Release 3.2.

MACAddress

(Read Only) – The MAC address used by Intel(R) AMT in a string format. For Example: 01-02-3f-b0-99-99. This property is only visible / usable for users of ADMINISTRATION realm.

LinkIsUp

(Read Only) – Indicates whether the network link is up.

LinkPolicy

Policy for link availability according to different power states. This property is only visible / usable for users of ADMIN_SECURITY_ADMINISTRATION realm.

 

Click here for a snippet demonstrating this step

See the General Info Get Core Version use case for the GetCoreVersion function.

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

  

# Select the wired interface

$ethernetPortSettingsRef =$wsmanConnectionObject.NewReference("SELECT * FROM AMT_EthernetPortSettings WHERE InstanceID='Intel(r) AMT Ethernet Port Settings 0'")

$ethernetPortSettingsInterface =$ethernetPortSettingsRef.Get()

$fwVersion = GetCoreVersion

if(($fwVersion.ToString() -lt '4.0') -bor (($fwVersion.ToString() -ge '5.0') -band ($fwVersion.ToString() -lt '6.0')))

{

    $vlanTag =$ethernetPortSettingsInstance.GetProperty("VLANTag")

}

$sharedMAC =$ethernetPortSettingsInterface.GetProperty("SharedMAC")

$macAddress =$ethernetPortSettingsInterface.GetProperty("MACAddress")

$linkIsUp =$ethernetPortSettingsInterface.GetProperty("LinkIsUp")

$linkPolicy =$ethernetPortSettingsInterface.GetProperty("LinkPolicy")

 

 

Additional Information

An interface set to receive manageability traffic in an Sx state will not receive such traffic if the selected power package limits ME activity to S0. See the list of power packages.

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.

 

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