CollapseAll image

Set/Get General Network Settings

The following steps describe how to manipulate the general network settings (that are not interface specific).

1.  Retrieve the instance of AMT_GeneralSettings, where the InstanceID key equals “Intel(r) AMT: General Settings”.

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

Property

Description

NetworkInterfaceEnabled

Indicates whether the network interface is enabled.

IdleWakeTimeout

Defines the minimum time value, in minutes, that Intel AMT will be operable after waking up from a sleep power state. This timer is restarted whenever Intel AMT is servicing requests. (See Power Packages.)

HostName

Host name for the Intel AMT device.

DomainName

Domain name for the Intel AMT device. Used for DNS Start of Authority (SOA) lookup.

PingResponseEnabled

Indicates whether Intel AMT should respond to ping Echo Request messages.

WsmanOnlyMode

Indicates whether Intel AMT should block network interfaces other than WS-Management.

SharedFQDN

Available from Intel AMT Release 6.0.

Defines whether the FQDN (HostName.DomainName) is shared with the Host or dedicated to ME. If set to FALSE, the FQDN is dedicated and must be different from the operating system HostName. Default: TRUE (shared).

RmcpPingResponseEnabled

Indicates whether Intel AMT should respond to RMCP ping Echo Request messages.

PresenceNotificationInterval

Defines the interval at which the Intel AMT will send periodic WS-management events notifications (for the subscribed clients) whenever network settings are changed. Units are minutes. A value of 0 disables periodic events. The minimal allowed value is 15 minutes. Default: 0

IPv6 related settings (Intel AMT 6.0 and later)

PreferredAddressFamily

Preferred Address Family (IPv4/IPv6) used for controlling outbound traffic such as events and user initiated traffic. For such traffic, the preferred addressing family will be attempted first, but other considerations also apply, depending on the traffic and the destination.

DHCPv6ConfigurationTimeout

Defines the maximum duration (DHCPv6 MRD for the Solicit Message) in seconds during which the Intel AMT tries to locate a DHCPv6 server. 0 - means try forever. Default: 0

DDNS related settings (Intel AMT 6.0 and later)

Intel AMT 6.0 includes a DDNS (Dynamic DNS) update client that allows updating the DNS with Intel AMT’s FQDN and address information. Only forward lookup records: A (ipv4) and AAAA (ipv6) are updated.

DDNSUpdateEnabled

Optional property that defines whether the DDNS update client in Intel AMT is enabled or not.

When this property is not included when updating AMT_GeneralSettings (as in versions previous to 6.0), then Intel AMT will work in backwards compatibility mode, where it will try to update the DNS via the DHCP server by using DHCP option 81.

When this property is included and is set to TRUE, Intel AMT will register a dedicated FQDN in the DNS. Intel AMT will update a shared FQDN in the DNS based on the response received from the DHCP Server in DHCP option 81.

When this property is included and is set to FALSE, Intel AMT will not include option 81 in DHCP requests and will not attempt to update DNS.

The default value of this property is Disabled.

DDNSUpdateByDHCPServerEnabled

Added in Intel AMT Release 8.0.

When DDNSUpdateEnabled is set to FALSE, this property allows the explicit setting of whether or not a DDNS update should be requested from the DHCP server for the shared IPv4 address and shared FQDN.

When DDNSUpdateEnabled is set to TRUE, this property is not applicable.

When DDNSUpdateEnabled is set to FALSE and this property is set to FALSE, DDNS Update is disabled.

When DDNSUpdateEnabled is set to FALSE and this property is set to TRUE, DDNS update is enabled for shared IPv4 and FQDN and updated by DHCP option 81.

This property is not supported by MEBx.

DDNSTTL

Defines the Time To Live value (cacheable time) of Resource Records registered by the DDNS update client. Units are seconds. Default: 900 (15 minutes)

DDNSPeriodicUpdateInterval

Defines the interval at which the DDNS update client will send periodic updates for all the Resource Records registered by Intel AMT. Should be set according to corporate DNS scavenging policy. Units are minutes. A value of 0 means never send an update. The minimal allowed value is 20 minutes. Default: 1440 (24 hours)

 

 Note:

   The HostName and DomainName cannot have a “-“  or a “_” at the beginning or the end of the string defining them.

   Intel AMT registers an FQDN in the enterprise DNS using DHCP option 81 to do so. Intel AMT versions 6.0 and up attempt to update the DNS directly using the DDNS Update client. If Intel AMT is active (i.e., the host OS is not active), the DNS record will be the host name plus the Intel AMT domain name. If no domain name was set, Intel AMT will not send any DDNS Updates and will request that the DHCP Server update the DNS via DHCP option 81, which in this case will include only the host name.

   When ping is enabled and Intel AMT shares its IP address with the host, then Intel AMT will only respond to pings when the host OS is down or the OS is up but the interface driver (wired or wireless) is not present.

   When Intel AMT device is connected via a VPN tunnel or by an MPS connection, it will not respond to pings, even if ping response was enabled.

 

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.

  

$generalSettingsRef = $wsmanConnectionObject.NewReference("SELECT * FROM AMT_GeneralSettings where InstanceID='Intel(r) AMT: General Settings'")

$generalSettingInstance = $generalSettingsRef.Get()

$generalSettingInstance.SetProperty("NetworkInterfaceEnabled", "true")

$generalSettingInstance.SetProperty("IdleWakeTimeout", "5")

$generalSettingInstance.SetProperty("HostName", "demo")

$generalSettingInstance.SetProperty("DomainName", "intel.com")

$generalSettingInstance.SetProperty("PingResponseEnabled", "true")

$generalSettingInstance.SetProperty("WsmanOnlyMode", "true")

$generalSettingInstance.SetProperty("RmcpPingResponseEnabled", "true")

$generalSettingInstance.SetProperty("PresenceNotificationInterval", "15")

$fwVersion = GetCoreVersion

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

{

    $generalSettingInstance.SetProperty("SharedFQDN", "true")

    $generalSettingInstance.SetProperty("PreferredAddressFamily", "0")

    $generalSettingInstance.SetProperty("DHCPv6ConfigurationTimeout", "0")

    $generalSettingInstance.SetProperty("DDNSUpdateEnabled", "false")

    $generalSettingInstance.SetProperty("DDNSTTL", "1000")

    $generalSettingInstance.SetProperty("DDNSPeriodicUpdateInterval", "1440")

}

$generalSettingsRef.Put($generalSettingInstance)

 

 

Additional Information

If DDNS is not enabled and the platform is in the S5 power state, changing the HostName to an empty value will result in Intel AMT sending the previous (non-empty) HostName in a DHCP Option 81 message.

Instance Diagram

Classes Used in This Flow

SDK Sample

Located at:<SDK_root>\Windows\Intel_AMT\Samples\WS-Management\NetworkAdministration\c#

 

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