Metric specifies the interface metric used to distinguish between multiple matching routes of the same prefix length. If multiple route prefixes match a packet destination, the route with the longest prefix length is preferred. If multiple matching routes exist with the same prefix length, then the route with the lower metric is used.

If Metric is not specified, an automatic metric is generated.

The settings under Route must be added in the following order: Identifier, Metric, NextHopAddress, and then Prefix. 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.

Values

Metric

Specifies the interface metric used to distinguish between multiple matching routes of the same prefix length.

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>
	<!-- Target the interface with identifier "Ethernet 1" --> 	 <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>
<Interfaces>
   <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>123</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>456</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>

See Also

Concepts

Route