How to Set the PXE Service Point Response to All Network Interfaces

Article
10/04/2022

In Configuration Manager, you set the operating system deployment PXE service point response to network interfaces by setting the BindPolicy embedded property.

BindPolicy has the following possible values.

Value	Description
0	Responds to PXE requests on all network interfaces.
1	Responds to requests on specific network interfaces.

If BindPolicy is set to respond to specific network interfaces (1), you must add the media access control (MAC) addresses for the required network interfaces by using the BindExcept list. If BindExcept is not populated, PXE will not respond to any requests. For more information see, How to Set the PXE Service Point Response for a Specific Network Interface.

To set the PXE response to network interfaces

Set up a connection to the SMS Provider. For more information, see SMS Provider fundamentals.
Make a connection to the distribution point instance with PXE enabled.
Get the embedded properties.
Update the BindPolicy embedded property.
Commit the changes to the site control file.

Example

The following example method sets the PXE service point response to a network interface. If respondToSpecificInterface is set to 1 you must set the BindExcept list to specify the network interfaces that can respond. For more information, see How to Set the PXE Service Point Response for a Specific Network Interface.

For information about calling the sample code, see Calling Configuration Manager Code Snippets.

public void SetNetworkInterface(WqlConnectionManager connection,                                  string siteCode,                                  string serverName,                                  string respondToSpecificInterface){    try    {        //Connect to distribution point instance.                        IResultObject siteRole = connection.GetInstance("SMS_SCI_SysResUse.FileType=2,ItemName=\"[\\\"Display=\\\\\\\\" + serverName + "\\\\\\\"]MSWNET:[\\\"SMS_SITE=" + siteCode + "\\\"]\\\\\\\\" + serverName + "\\\\,SMS Distribution Point\",ItemType=\"System Resource Usage\",SiteCode=" + "\"" + siteCode + "\"");        // Create temporary copy of the embedded properties.        Dictionary<string, IResultObject> embeddedProperties = siteRole.EmbeddedProperties;        // Enumerate through the embedded properties and makes changes as needed.        foreach (KeyValuePair<string, IResultObject> kvp in siteRole.EmbeddedProperties)        {            // Setting: BindPolicy            if (kvp.Value.PropertyList["PropertyName"] == "BindPolicy")            {                // Get current property value.                Console.WriteLine();                Console.WriteLine("Property: {0}", kvp.Value.PropertyList["PropertyName"]);                Console.WriteLine("Current value: {0}", kvp.Value.PropertyList["Value"]);                // Change value.                embeddedProperties["BindPolicy"]["Value"].StringValue = respondToSpecificInterface;                Console.WriteLine("Setting the {0} value to {1}.", kvp.Value.PropertyList["PropertyName"], respondToSpecificInterface);            }        }        // Store the settings that have changed.        siteRole.EmbeddedProperties = embeddedProperties;        // Save the settings.         siteRole.Put();    }    catch (SmsException ex)    {        Console.WriteLine();        Console.WriteLine("Failed. Error: " + ex.InnerException.Message);    }}

The example method has the following parameters:

Parameter	Type	Description
`connection`	Managed: `WqlConnectionManager`	A valid connection to the SMS Provider.
`siteCode`	Managed: `String`	The Configuration Manager site code.
`serverName`	Managed: `String`	The server name. For example, `"SERVER1.DOMAIN1.COM"`.
`respondToSpecficInterface`	Managed: `String`	The value to set which network interfaces will respond to PXE requests. - 0 - Responds to PXE requests on all network interfaces. - 1 - Responds to requests on specific network interfaces.

Compiling the Code

The C# example has the following compilation requirements:

Namespaces

System

System.Collections.Generic

System.Text

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Robust Programming

For more information about error handling, see About Configuration Manager Errors.

.NET Framework Security

For more information about securing Configuration Manager applications, see Configuration Manager role-based administration.

Share via