This documentation is archived and is not being maintained.

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

Parent Hierarchy

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

Show: