Share via

Interface

Interface contains all of the 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.

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 Passes

specialize

windowsPE

Parent Hierarchy

Microsoft-Windows-TCPIP | Interfaces | Interface

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

Interfaces