This documentation is archived and is not being maintained.

Identifier

Identifier specifies the interface to apply to the other settings within Interface. It can be expressed in any one of the following ways:

  • The string representation of an interface net locally unique identifier (NetLUID) (0x6000001000000)
  • The interface alias (for example, Local Area Connection)
  • The MAC address of the interface (00-11-22-33-44-55)

Values

 

Identifier

Specifies the interface the interface to apply to the other settings within Interface. Identifier is a string with a maximum length of 256 characters.

This string type does not support empty elements. Do not create an empty value for this setting.

noteNote
In computers with multiple occurrences of the same type of network interface, such as a LAN connection, the LUID and interface aliases for each interface are not guaranteed to be the same between different builds. After installation, verify that the settings were applied to the correct interface.

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

Interface

Show: