Metric

Metric specifies the interface metric for the IPv4 protocol. When routes are chosen, the overall metric used to determine the preference is the sum of the route metric and the interface metric. Typically, the interface metric gives preference to a particular interface, such as using wired if both wired and wireless are available.

If a preference is not specified, the stack will choose an automatic metric, such as automatically preferring wired over wireless.

Values

metric

Specifies the interface metric for the IPv4 protocol. The range is from five (more than 2 gigabytes (GB) per second) to 50 (less than 500 kilobytes (KB) per second).

Valid Passes

specialize

windowsPE

Parent Hierarchy

Microsoft-Windows-TCPIP | Interfaces | Interface | Ipv4Settings | Metric

Applies To

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

XML Example

The following XML output shows how to configure TCPIP.

<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>
      <Routes>
         <Route wcm:action="add">
            <Identifier>1</Identifier> 
            <Metric>10</Metric> 
            <NextHopAddress>10.0.0.1</NextHopAddress> 
            <Prefix>10</Prefix> 
         </Route>
         <Route wcm:action="add">
            <Identifier>10</Identifier> 
            <Metric>29</Metric> 
            <NextHopAddress>123.45.67.8</NextHopAddress> 
            <Prefix>234</Prefix> 
         </Route>
      </Routes>
      <UnicastIpAddresses>
         <IpAddress wcm:action="add" wcm:keyValue="1">123.45.6.78</IpAddress> 
         <IpAddress wcm:action="add" wcm:keyValue="2">fff:1::3</IpAddress> 
      </UnicastIpAddresses>
      <Identifier>123</Identifier>
   </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>
      <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>123.45.67/8</NextHopAddress> 
            <Prefix>12345</Prefix> 
         </Route>
      </Routes>
      <Identifier>456</Identifier> 
   </Interface>
</Interfaces>

See Also

Concepts

Ipv4Settings