Interface contains settings for the TCP/IP interface.

TCP/IP settings can be divided into two primary groups—global settings and interface settings. Global settings apply to the protocols as a whole and are applied across all network interfaces. Interface settings are specific to a particular network interface.

Note
The settings in Interface must be added in the following order: Ipv4Settings, Ipv6Settings, Identifier, UnicastIpAddresses, and then Routes. After saving your Unattend file in Windows SIM, verify in the XML file that the output is shown in the correct order, as shown in the XML example below.

Child Elements

Identifier

Specifies the interface to apply to the other settings within Interface.

Ipv4Settings

Specifies settings for the IP version 4 interface.

Ipv6Settings

Specifies settings for the IP version 6 interface.

Routes

Specifies the IPv4 and IPv6 routes.

UnicastIpAddresses

Specifies the unicast IP addresses for the IPv4 and IPv6 settings.

Valid Configuration Passes

specialize

windowsPE

Parent Hierarchy

Applies To

For a list of the Windows® editions and architectures that this component supports, see Microsoft-Windows-TCPIP.

XML Example

The following XML output shows how to configure TCPIP.

  Copy Code 
<component name="Microsoft-Windows-TCPIP" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <Interfaces>
   <!-- Add static IP address (192.168.0.1/24, ffff:1::3/48) & route (12.34.0.0/16) to interface with identifier "Ethernet 1" --> <Interface wcm:action="add">
		 <Ipv4Settings>
			<DhcpEnabled>true</DhcpEnabled> 
			<Metric>20</Metric> 
			<RouterDiscoveryEnabled>false</RouterDiscoveryEnabled> 
		 </Ipv4Settings>
		 <Ipv6Settings>
			<DhcpEnabled>false</DhcpEnabled> 
			<Metric>30</Metric> 
			<RouterDiscoveryEnabled>true</RouterDiscoveryEnabled> 
		 </Ipv6Settings>
	<Identifier>Ethernet 1</Identifier>
		 <UnicastIpAddresses>
		 <IpAddress wcm:action="add" wcm:keyValue="1">192.168.0.1/24</IpAddress>
		 <IpAddress wcm:action="add" wcm:keyValue="2">ffff:1::3/48</IpAddress>
		 </UnicastIpAddresses>
		 <Routes>
			<Route wcm:action="add">
			 <Identifier>1</Identifier> 
			 <Metric>10</Metric> 
			 <NextHopAddress>12.34.0.0</NextHopAddress> 
			 <Prefix>16</Prefix> 
			</Route>
			<Route wcm:action="add">
			 <Identifier>10</Identifier> 
			 <Metric>29</Metric> 
			 <NextHopAddress>12.34.56.0</NextHopAddress> 
			 <Prefix>24</Prefix> 
			</Route>
		 </Routes>
	</Interface>
	<Interface wcm:action="add">
		 <Ipv4Settings>
			<DhcpEnabled>true</DhcpEnabled> 
			<Metric>20</Metric> 
			<RouterDiscoveryEnabled>false</RouterDiscoveryEnabled> 
		 </Ipv4Settings>
		 <Ipv6Settings>
			<DhcpEnabled>false</DhcpEnabled> 
			<Metric>10</Metric> 
			<RouterDiscoveryEnabled>true</RouterDiscoveryEnabled> 
		 </Ipv6Settings>
		 <Identifier>Local Area Connection</Identifier> 
		 <UnicastIpAddresses>
			<IpAddress wcm:action="add" wcm:keyValue="1">123.45.67.8</IpAddress> 
			</UnicastIpAddresses>
		 <Routes>
			<Route wcm:action="add">
			 <Identifier>1</Identifier> 
			 <Metric>10</Metric> 
			 <NextHopAddress>12.34.0.0</NextHopAddress> 
			 <Prefix>16</Prefix> 
			</Route>
		 </Routes>
	</Interface>
   </Interfaces>
</component>

See Also

Concepts

Interfaces