Home Reference WMI Reference root CIMV2 Win32_NetworkAdapterConfiguration
 

Win32_NetworkAdapterConfiguration

The Win32_NetworkAdapterConfiguration class represents the attributes and behaviors of a network adapter. This class has been extended to include extra properties and methods that support the management of the TCP/IPprotocols (and are independent of the network adapter).

Quick Start

Properties

In this WMI class, all WMI properties are read-only. You can only read values but not change them.

ApplicationId

Data type String

ArpAlwaysSourceRoute

Data type Boolean

The ArpAlwaysSourceRoute property indicates whether the Address Resolution Protocol (ARP) must always use source routing. If this property is $true, TCP/IP will transmit ARP queries with source routing enabled on Token Ring networks. By default, ARP first queries without source routing, and retries with source routing enabled if no reply was received. Source routing allows the routing of network packets across different types of networks. Default: $false.

ArpUseEtherSNAP

Data type Boolean

The ArpUseEtherSNAP property indicates whether Ethernet packets follow the IEEE 802.3 Sub-Network Access Protocol (SNAP) encoding. Setting this parameter to 1 will force TCP/IP to transmit Ethernet packets using 802.3 SNAP encoding. By default, the stack transmits packets in DIX Ethernet format. Windows NT/Windows 2000 systems are able to receive both formats. Default: $false.

Caption

Data type String

A short textual description (one-line string) of the CIM_Setting object.

DatabasePath

Data type String

The DatabasePath property indicates a valid Windows file path to standard Internet database files (HOSTS, LMHOSTS, NETWORKS, PROTOCOLS). The file path is used by the Windows Sockets interface. This property is only available on Windows NT/Windows 2000 systems.

DeadGWDetectEnabled

Data type Boolean

The DeadGWDetectEnabled property indicates whether dead gateway detection occurs. Setting this parameter to $true causes TCP to perform Dead Gateway Detection. With this feature enabled, TCP will ask IP to change to a backup gateway if it retransmits a segment several times without receiving a response. Default: $true.

DefaultIPGateway

Data type String[] (Array)

The DefaultIPGateway property contains a list of IP addresses of default gateways used by the computer system.

Example: 194.161.12.1 194.162.46.1

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

DefaultTOS

Data type UInt8

The DefaultTOS property indicates the default Type Of Service (TOS) value set in the header of outgoing IP packets. RFC 791 defines the values. Default: 0, Valid Range: 0 – 255.

DefaultTTL

Data type UInt8

The DefaultTTL property indicates the default Time To Live (TTL) value set in the header of outgoing IP packets. The TTL specifies the number of routers an IP packet may pass through to reach its destination before being discarded. Each router decrements the TTL count of a packet by one as it passes through and discards the packets if the TTL is 0. Default: 32, Valid Range: 1 – 255.

Description

Data type String

A textual description of the CIM_Setting object.

DHCPEnabled

Data type Boolean

The DHCPEnabled property indicates whether the dynamic host configuration protocol (DHCP) server automatically assigns an IP address to the computer system when establishing a network connection.

Values: $true or $false. If $true, DHCP is enabled.

DHCPLeaseExpires

Data type DateTime

The DHCPLeaseExpires property indicates the expiration date and time for a leased IP address that was assigned to the computer by the dynamic host configuration protocol (DHCP) server.

Example: 20521201000230.000000000

DHCPLeaseObtained

Data type DateTime

The DHCPLeaseObtained property indicates the date and time the lease was obtained for the IP address assigned to the computer by the dynamic host configuration protocol (DHCP) server.

Example: 19521201000230.000000000

DHCPServer

Data type String

The DHCPServer property indicates the IP address of the dynamic host configuration protocol (DHCP) server.

Example: 154.55.34

DNSDomain

Data type String

The DNSDomain property indicates an organization name followed by a period and an extension that indicates the type of organization, such as microsoft.com. The name can be any combination of the letters A through Z, the numerals 0 through 9, and the hyphen (-), plus the period (.) character used as a separator.

Example: microsoft.com

DNSDomainSuffixSearchOrder

Data type String[] (Array)

The DNSDomainSuffixSearchOrder property specifies the DNS domain suffixes to be appended to the end of host names during name resolution. When attempting to resolve a fully qualified domain name (FQDN) from a host only name, the system will first append the local domain name. If this is not successful, the system will use the domain suffix list to create additional FQDNs in the order listed and query DNS servers for each.

Example: samples.microsoft.com example.microsoft.com

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

DNSEnabledForWINSResolution

Data type Boolean

The DNSEnabledForWINSResolution property indicates whether the Domain Name System (DNS) is enabled for name resolution over Windows Internet Naming Service (WINS) resolution. If the name cannot be resolved using DNS, the name request is forwarded to WINS for resolution.

DNSHostName

Data type String

The DNSHostName property indicates the host name used to identify the local computer for authentication by some utilities. Other TCP/IP-based utilities can use this value to acquire the name of the local computer. Host names are stored on DNS servers in a table that maps names to IP addresses for use by DNS. The name can be any combination of the letters A through Z, the numerals 0 through 9, and the hyphen (-), plus the period (.) character used as a separator. By default, this value is the Microsoft networking computer name, but the network administrator can assign another host name without affecting the computer name.

Example: corpdns

DNSServerSearchOrder

Data type String[] (Array)

The DNSServerSearchOrder property indicates an ordered list of server IP addresses to be used in querying for DNS Servers.

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

DomainDNSRegistrationEnabled

Data type Boolean

The DomainDNSRegistrationEnabled property specifies whether the IP addresses for this connection are registered in DNS under the domain name of this connection, in addition to registering under the computer’s full DNS name. The domain name of this connection is either set via the method SetDNSDomain() or assigned by DHCP. The registered name is the host name of the computer with the domain name appended. Windows 2000 only.

ForwardBufferMemory

Data type UInt32

The ForwardBufferMemory property indicates how much memory IP allocates to store packet data in the router packet queue. When this buffer space is filled, the router begins discarding packets at random from its queue. Packet queue data buffers are 256 bytes in length, so the value of this parameter should be a multiple of 256. Multiple buffers are chained together for larger packets. The IP header for a packet is stored separately. This parameter is ignored and no buffers are allocated if the IP router is not enabled. The buffer size can range from the network MTU to the a value smaller than 0xFFFFFFFF. Default: 74240 (fifty 1480-byte packets, rounded to a multiple of 256).

FullDNSRegistrationEnabled

Data type Boolean

The FullDNSRegistrationEnabled property specifies whether the IP addresses for this connection are registered in DNS under the computer’s full DNS name. The full DNS name of the computer is displayed on the Network Identification tab of the System Control Panel. Windows 2000 only.

GatewayCostMetric

Data type UInt16[] (Array)

The GatewayCostMetric reflects an integer cost metric (ranging from 1 to 9999) to be used in calculating the fastest, most reliable, and/or least expensive routes. This argument has a one to one correspondence with the DefaultIPGateway. Windows 2000 only.

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

IGMPLevel

Data type UInt8

The IGMPLevel property indicates the extent to which the system supports IP multicast and participates in the Internet Group Management Protocol. At level 0, the system provides no multicast support. At level 1, the system may only send IP multicast packets. At level 2, the system may send IP multicast packets and fully participate in IGMP to receive multicast packets. Default: 2

$IGMPLevel_ReturnValue = 
@{
    0='No Multicast'
    1='IP Multicast'
    2='IP & IGMP multicast'
}

Index

Data type UInt32

The Index property specifies the index number of the Win32 network adapter configuration. The index number is used when there is more than one configuration available.

InterfaceIndex

Data type UInt32

The InterfaceIndex property contains the index value that uniquely identifies the local interface.

IPAddress

Data type String[] (Array)

The IPAddress property contains a list of all of the IP addresses associated with the current network adapter.

Example: 155.34.22.0

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

IPConnectionMetric

Data type UInt32

The IPConnectionMetric indicates the cost of using the configured routes for this IP bound adapter and is the weighted value for those routes in the IP routing table. If there are multiple routes to a destination in the IP routing table, the route with the lowest metric is used. The default value is 1.Windows 2000 only.

IPEnabled

Data type Boolean

The IPEnabled property indicates whether TCP/IP is bound and enabled on this network adapt.

IPFilterSecurityEnabled

Data type Boolean

The IPFilterSecurityEnabled property indicates whether IP port security is enabled globally across all IP-bound network adapters. This property is used in conjunction with IPSecPermitTCPPorts, IPSecPermitUDPPorts, and IPSecPermitIPProtocols. A value of $true indicates that IP port security is enabled and that the security values associated with individual network adapters are in effect. A value of $false indicates IP filter security is disabled across all network adapters and allows all port and protocol traffic to flow unfiltered.

IPPortSecurityEnabled

Data type Boolean

The IPPortSecurityEnabled property indicates whether IP port security is enabled globally across all IP-bound network adapters. This property has been deprecated in favor of IPFilterSecurityEnabled.

IPSecPermitIPProtocols

Data type String[] (Array)

The IPSecPermitIPProtocols property lists the protocols permitted to run over the IP. The list of protocols is defined using the EnableIPSec method. The list will either be empty or contain numeric values. A numeric value of zero indicates access permission is granted for all protocols. An empty string indicates that no protocols are permitted to run when IPFilterSecurityEnabled is $true.

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

IPSecPermitTCPPorts

Data type String[] (Array)

The IPSecPermitTCPPorts property lists the ports that will be granted access permission for TCP. The list of protocols is defined using the EnableIPSec method. The list will either be empty or contain numeric values. A numeric value of zero indicates access permission is granted for all ports. An empty string indicates that no ports are granted access permission when IPFilterSecurityEnabled is $true.

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

IPSecPermitUDPPorts

Data type String[] (Array)

The IPSecPermitUDPPorts property lists the ports that will be granted User Datagram Protocol (UDP) access permission. The list of protocols is defined using the EnableIPSec method. The list will either be empty or contain numeric values. A numeric value of zero indicates access permission is granted for all ports. An empty string indicates that no ports are granted access permission when IPFilterSecurityEnabled is $true.

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

IPSubnet

Data type String[] (Array)

The IPSubnet property contains a list of all the subnet masks associated with the current network adapter.

Example: 255.255.0

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

IPUseZeroBroadcast

Data type Boolean

The IPUseZeroBroadcast property indicates whether IP zeros-broadcasts are used. If this parameter is set $true, then IP uses zeros-broadcasts (0.0.0.0), and the system uses ones-broadcasts (255.255.255.255). Computer systems generally use ones-broadcasts, but those derived from BSD implementations use zeros-broadcasts. Systems that do not use that same broadcasts will not interoperate on the same network. Default: $false.

IPXAddress

Data type String

The IPXAddress property indicates the Internetworking Packet Exchange (IPX) address of the network adapter. The IPX address identifies a computer system on a network using the IPX protocol.

IPXEnabled

Data type Boolean

The IPXEnabled property determines whether the or Internetwork Packet Exchange (IPX) protocol is bound and enabled for this adapter.

IPXFrameType

Data type UInt32[] (Array)

The IPXFrameType property represents an integer array of frame type identifiers. The values in this array correspond to the elements in the IPXNetworkNumber.

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

$IPXFrameType_ReturnValue = 
@{
    0='Ethernet II'
    1='Ethernet 802.3'
    2='Ethernet 802.2'
    3='Ethernet SNAP'
  255='AUTO'
}

IPXMediaType

Data type UInt32

The IPXMediaType property represents an Internetworking Packet Exchange (IPX) media type identifier.

$IPXMediaType_ReturnValue = 
@{
    1='Ethernet'
    2='Token ring'
    3='FDDI'
    8='ARCNET'
}

IPXNetworkNumber

Data type String[] (Array)

The IPXNetworkNumber property represents an array of characters that uniquely identifies a frame/network adapter combination on the computer system. The NetWare Link (NWLink) IPX/SPX-compatible transport in Windows 2000 and Windows NT 4.0 and greater uses two distinctly different types of network numbers. This number is sometimes referred to as the external network number. It must be unique for each network segment. The order in this string list will correspond item-for-item with the elements in the IPXFrameType property.

 This property is an array. It contains multiple values. Use square brackets to index individual values, or use the PowerShell -join operator to convert the array to a string.

IPXVirtualNetNumber

Data type String

The IPXVirtualNetNumber property uniquely identifies the computer system on the network. It is represented in the form of an eight-character hexadecimal digit. Windows NT/2000 uses the virtual network number (also known as an internal network number) for internal routing.

KeepAliveInterval

Data type UInt32

The KeepAliveInterval property indicates the interval separating Keep Alive Retransmissions until a response is received. Once a response is received, the delay until the next Keep Alive Transmission is again controlled by the value of KeepAliveTime. The connection will be aborted after the number of retransmissions specified by TcpMaxDataRetransmissions have gone unanswered. Default: 1000, Valid Range: 1 – 0xFFFFFFFF.

KeepAliveTime

Data type UInt32

The KeepAliveTime property indicates how often the TCP attempts to verify that an idle connection is still intact by sending a Keep Alive Packet. A remote system that is reachable will acknowledge the keep alive transmission. Keep Alive packets are not sent by default. This feature may be enabled in a connection by an application. Default: 7,200,000 (two hours)

MACAddress

Data type String

The MACAddress property indicates the Media Access Control (MAC) address of the network adapter. A MAC address is assigned by the manufacturer to uniquely identify the network adapter.

Example: 00:80:C7:8F:6C:96

MTU

Data type UInt32

The MTU property overrides the default Maximum Transmission Unit (MTU) for a network interface. The MTU is the maximum packet size (including the transport header) that the transport will transmit over the underlying network. The IP datagram can span multiple packets. The range of this value spans the minimum packet size (68) to the MTU supported by the underlying network.

NumForwardPackets

Data type UInt32

The NumForwardPackets property indicates the number of IP packet headers allocated for the router packet queue. When all headers are in use, the router will begin to discard packets from the queue at random. This value should be at least as large as the ForwardBufferMemory value divided by the maximum IP data size of the networks connected to the router. It should be no larger than the ForwardBufferMemory value divided by 256, since at least 256 bytes of forward buffer memory are used for each packet. The optimal number of forward packets for a given ForwardBufferMemory size depends on the type of traffic carried on the network. It will lie somewhere between these two values. If the router is not enabled, this parameter is ignored and no headers are allocated. Default: 50, Valid Range: 1 – 0xFFFFFFFE.

PMTUBHDetectEnabled

Data type Boolean

The PMTUBHDetectEnabled property indicates whether detection of black hole routers occurs. Setting this parameter to $true causes TCP to try to detect black hole routers while discovering the path of the Maximum Transmission Unit. A black hole router does not return ICMP Destination Unreachable messages when it needs to fragment an IP datagram with the Don’t Fragment bit set. TCP depends on receiving these messages to perform Path MTU Discovery. With this feature enabled, TCP will try to send segments without the Don’t Fragment bit set if several retransmissions of a segment go unacknowledged. If the segment is acknowledged as a result, the MSS will be decreased and the Don’t Fragment bit will be set in future packets on the connection. Enabling black hole detection increases the maximum number of retransmissions performed for a given segment. The default value of this property is $false.

PMTUDiscoveryEnabled

Data type Boolean

The PMTUDiscoveryEnabled property indicates whether the Maximum Transmission Unit (MTU) path is discovered. Setting this parameter to $true causes TCP to attempt to discover the MTU (the largest packet size) over the path to a remote host. By discovering the MTU path and limiting TCP segments to this size, TCP can eliminate fragmentation at routers along the path that connect networks with different MTUs. Fragmentation adversely affects TCP throughput and network congestion. Setting this parameter to $false causes an MTU of 576 bytes to be used for all connections that are not to machines on the local subnet. Default: $true.

ServiceName

Data type String

The ServiceName property indicates the service name of the network adapter. This name is usually shorter than the full product name.

Example: Elnkii.

SettingID

Data type String

The identifier by which the CIM_Setting object is known.

TcpipNetbiosOptions

Data type UInt32

The TcpipNetbiosOptions property specifies a bitmap of the possible settings related to NetBIOS over TCP/IP. Windows 2000 only.

TcpMaxConnectRetransmissions

Data type UInt32

The TcpMaxConnectRetransmissions property indicates the number of times TCP will attempt to retransmit a Connect Request before terminating the connection. The initial retransmission timeout is 3 seconds. The retransmission timeout doubles for each attempt. Default: 3, Valid Range: 0 – 0xFFFFFFFF.

TcpMaxDataRetransmissions

Data type UInt32

The TcpMaxDataRetransmissions property indicates the number of times TCP will retransmit an individual data segment (non-connect segment) before terminating the connection. The retransmission timeout doubles with each successive retransmission on a connection. Default: 5, Valid Range: 0 – 0xFFFFFFFF.

TcpNumConnections

Data type UInt32

The TcpNumConnections property indicates the maximum number of connections that TCP can have open simultaneously. Default: 0xFFFFFE, Valid Range: 0 – 0xFFFFFE.

TcpUseRFC1122UrgentPointer

Data type Boolean

The TcpUseRFC1122UrgentPointer property indicates whether TCP uses the RFC 1122 specification or the mode used by Berkeley Software Design (BSD) derived systems, for urgent data. The two mechanisms interpret the urgent pointer differently and are not interoperable. Windows 2000 and Windows NT version 3.51 and higher defaults to BSD mode. If $true, urgent data is sent in RFC 1122 mode. Default: $false.

TcpWindowSize

Data type UInt16

The TcpWindowSize property contains the maximum TCP Receive Window size offered by the system. The Receive Window specifies the number of bytes a sender may transmit without receiving an acknowledgment. In general, larger receiving windows will improve performance over high delay and high bandwidth networks. For efficiency, the receiving window should be an even multiple of the TCP Maximum Segment Size (MSS). Default: Four times the maximum TCP data size or an even multiple of TCP data size rounded up to the nearest multiple of 8192. Ethernet networks default to 8760. Valid Range: 0 – 65535.

WINSEnableLMHostsLookup

Data type Boolean

The WINSEnableLMHostsLookup property indicates whether local lookup files are used. Lookup files will contain a map of IP addresses to host names. If they exist on the local system, they will be found in %SystemRoot%\system32\drivers\etc.

WINSHostLookupFile

Data type String

The WINSHostLookupFile property contains a path to a WINS lookup file on the local system. This file will contain a map of IP addresses to host names. If the file specified in this property is found, it will be copied to the %SystemRoot%\system32\drivers\etc folder of the local system. Valid only if the WINSEnableLMHostsLookup property is $true.

WINSPrimaryServer

Data type String

The WINSPrimaryServer property indicates the IP address for the primary WINS server.

WINSScopeID

Data type String

The WINSScopeID property provides a way to isolate a group of computer systems that communicate with each other only. The Scope ID is a character string value that is appended to the end of the NetBIOS name. It is used for all NetBIOS transactions over TCP/IP communications from that computer system. Computers configured with identical Scope IDs are able to communicate with this computer. TCP/IP clients with different Scope IDs disregard packets from computers with this Scope ID. Valid only when the EnableWINS method executes successfully.

WINSSecondaryServer

Data type String

The WINSSecondaryServer property indicates the IP address for the secondary WINS server.

Methods

Examples

See Also

Help and Questions

  Community Content

You are cordially invited to add knowledge to this page. If you have sample code or additional information related to this WMI class, please share it. Use the comment form to send your information. We will edit and incorparate it into the reference library. Thank you!

Please do not use the comment form to submit questions. If you have questions or need assistance, visit our free forum: Help me with WMI.

Content last updated: 2013-12-27 12:27:15 (UTC).

Facebooktwittergoogle_pluspinterestlinkedinFacebooktwittergoogle_pluspinterestlinkedin