Partager via


Key

Applies To: Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Vista

Key specifies a unique key for an IP address.

Note

  • This setting does not appear in the Properties pane of Windows® System Image Manager (Windows SIM) until you add IpAddress to the unattended installation answer file.

  • The value for Key is added to the answer file as an attribute of the IpAddress element. The attribute wcm:keyValue is used to identify each unique IP address. For example, you can specify three different IP addresses by using the Key value of 1, 2, and 3.

  • Values

    Key

    Specifies a unique key for the IpAddress. Key is a string.

    Valid Configuration Passes

    specialize

    windowsPE

    Parent Hierarchy

    Microsoft-Windows-TCPIP | Interfaces | Interface | UnicastIpAddresses | IpAddress | Key

    Applies To

    For a 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 TCP/IP.

    <component name="Microsoft-Windows-TCPIP" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="https://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>
    

    See Also

    Concepts

    IpAddress