UnicastIpAddresses specifies the unicast IP addresses for the IPv4 and IPv6 settings.

Note
The settings in Interface must be added in the following order: Ipv4Settings, Ipv6Settings, Identifier, UnicastIpAddresses, and then Routes, as shown in the XML example below.

Child Elements

IpAddress

Specifies a static unicast IP address for the interface.

Valid Configuration Passes

specialize

windowsPE

Parent Hierarchy

Microsoft-Windows-TCPIP | Interfaces | Interface | UnicastIpAddresses

Applies To

For the 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>
	<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>
<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>
	<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>
</component>

See Also

Concepts

Interface