CollapseAll image

Configuring Environment Detection

The following steps describe how to configure the DNS information that will be used by Intel AMT to dynamically determine the network it is operating in.

1.  Identify the set of top level Domain Names that define the Enterprise Intranet. These are the set of names specified by the enterprise DHCP server (in the DHCPv4 option 15 field or the DHCPv6 option 24 field). For example, if the set of names are “site1.foo.com”, “site2.foo.com”, “…site10.foo.com”, the common top level Domain Name that is required is: “foo.com”.

The Domain Name string can be identified in the following ways:

   Collect information from client systems. The DNS information sent by the DHCP server is stored by Windows. The following batch file snippet shows an example using shell commands:

ipconfig /all | findstr /c:"Connection-specific DNS Suffix" /I > .\temp.txt

for /f "tokens=2 delims=:" %i in (.\temp.txt) do echo %i > dnsinfo.txt

   With Microsoft DHCP Server it is possible to query the DHCP option 15 from the DHCP servers, using the DHCP Server management API. Refer to the following link for more information: http://msdn.microsoft.com/en-us/library/aa363376(VS.85).aspx

 Note:

   Each Domain Name string must be 190 characters or less.

   Environment Detection can also be configured using dynamic IPv6 address prefixes. See the use of the DetectionIPv6LocalPrefixes property in step 4. This can be done with or without defining a list of domains.

2.  Retrieve the instance of AMT_EnvironmentDetectionSettingData, where the “InstanceID” key is “Intel(r) AMT Environment Detection Settings”.

3.  Set the following properties of AMT_EnvironmentDetectionSettingData:

Property

Value

DetectionStrings

An array of strings to use in the environment detection algorithm. For example: {“foo.com”, “<more domains if any>”}

Can be left Null if the environment is defined only by IPv6 local prefixes.

DetectionIPv6LocalPrefixes

Used to specify IPv6 local prefixes used independently of or in conjunction with DetectionStrings.

DetectionAlgorithm

Specifies which algorithm is used to determine whether the Intel AMT system is in an Enterprise or Non-Enterprise network.

Valid value: 0

(Currently, Intel AMT supports only this value)

4.  Invoke AMT_EnvironmentDetectionSettingData.Put.

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.

  

$environmentDetectionSettingDataRef =$wsmanConnectionObject.NewReference("SELECT * FROM AMT_EnvironmentDetectionSettingData WHERE InstanceID='Intel(r) AMT Environment Detection Settings'")

$environmentDetectionSettingDataInstance =$environmentDetectionSettingDataRef.Get()

$environmentDetectionSettingDataInstance.SetProperty("DetectionStrings","intel.com")

$fwVersion = GetCoreVersion

if($fwVersion.ToString() -ge "6.0")

{

    $environmentDetectionSettingDataInstance.SetProperty("DetectionIPv6LocalPrefixes","1234::/64")

}

$environmentDetectionSettingDataInstance.SetProperty("DetectionAlgorithm","0")

$environmentDetectionSettingDataRef.Put($environmentDetectionSettingDataInstance)

 

 

Instance Diagram

Classes Used in This Flow

SDK Sample

Not applicable

 

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