CollapseAll image

Retrieve Wireless Capabilities

The following steps describe how to retrieve the 802.11 subparagraph capabilities of the wireless interface.

1.     Retrieve the instance of CIM_WiFiPort, where the “DeviceID” key equals “WiFi Port 0”.

2.     From the CIM_WiFiPort instance, traverse the CIM_ElementCapabilities association to find the instance of CIM_WiFiPortCapabilities.

3.     Examine the SupportedPortTypes property to determine the 802.11 modes that the port supports: 802.11a, 802.11b, 802.11g, 802.11n or other.

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 AMT_PublicKeyManagementService instance.

$wifiPortRef =$wsmanConnectionObject.NewReference("SELECT * FROM CIM_WiFiPort WHERE DeviceID='WiFi Port 0'")

$elementCapabilitiesRef =$wsmanConnectionObject.NewReference("CIM_ElementCapabilities")

$elementCapabilitiesRef.AddSelector("ManagedElement",$wifiPortRef)

# Traverse to the CIM_ElementCapabilities instances that are connected to the CIM_WiFiPort instance.

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

{

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

    if ($elementCapabilitiesItem.Object.GetProperty("Capabilities").IsA("CIM_WiFiPortCapabilities"))

    {

          # Get the CIM_WiFiPortCapabilities object using its EPR.

          $wifiPortCapabilitiesInstance =$elementCapabilitiesItem.Object.GetProperty("Capabilities").Ref.Get()

          $supportedPortTypes =$wifiPortCapabilitiesInstance.GetProperty("SupportedPortTypes")

    }

}

 

 

4.     Retrieve the instance of CIM_IEEE8021xCapabilities, where the “InstanceID” key equals “Intel(r) AMT:IEEE 802.1x Capabilities”.

5.     Examine the SupportedAuthenticationProtocols property to determine the protocols supported by the associated endpoint: EAP-TLS, EAP-TTLS/MSCHAPv2, PEAPv0/EAP-MSCHAPv2, PEAPv1/EAP-GTC, EAP-FAST/MSCHAPv2, EAP-FAST/GTC, EAP-MD5, EAP-PSK, EAP-SIM, EAP-AKA and/or EAP-FAST/TLS.

Click here for a snippet demonstrating this step

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

  

$ieee8021xCapabilitiesRef =$wsmanConnectionObject.NewReference("SELECT * FROM CIM_IEEE8021xCapabilities WHERE InstanceID='Intel(r) AMT:IEEE 802.1x Capabilities'")

$ieee8021xCapabilitiesInstance =$ieee8021xCapabilitiesRef.Get()

$supportedAuthenticationProtocols =$ieee8021xCapabilitiesInstance.GetProperty("SupportedAuthenticationProtocols")

 

 

6.     Retrieve the instance of CIM_WiFiEndpointCapabilities, where the “InstanceID” key equals “Intel(r) AMT:WiFi Endpoint Capabilities”.

7.     Examine the SupportedAuthenticationMethods property to determine the set of IEEE 802.11 authentication methods supported by the associated WifiEndpoint: Open System, Shared Key, WPA PSK, WPA IEEE 802.1x, WPA2 PSK, WPA3 SAE, and WPA2 IEEE 802.1X.

note-icon Note:

Support for PSK was removed in Intel AMT release 11.0.
Support for WPA3 SAE added in Intel CSME 14.0.

8.     Examine the SupportedEncryptionMethods property to determine the set of IEEE 802.11 encryption methods supported by the associated WifiEndpoint: WEP, TKIP, CCMP, or None.

Click here for a snippet demonstrating this step

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

  

$wifiEndpointCapabilitiesRef =$wsmanConnectionObject.NewReference("SELECT * FROM CIM_WiFiEndpointCapabilities WHERE InstanceID='Intel(r) AMT:WiFi Endpoint Capabilities'")

$wifiEndpointCapabilitiesInstance =$wifiEndpointCapabilitiesRef.Get()

$supportedAuthenticationMethods =$wifiEndpointCapabilitiesInstance.GetProperty("SupportedAuthenticationMethods")

$supportedEncryptionMethods =$wifiEndpointCapabilitiesInstance.GetProperty("SupportedEncryptionMethods")

 

 

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:

   Wireless Profile Parameters

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