Win32_NetworkAdapterSetting class

Article
01/06/2021

The Win32_NetworkAdapterSetting association WMI class relates a network adapter and its configuration settings.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

[Dynamic, Provider("CIMWin32"), UUID("{8502C50A-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_NetworkAdapterSetting : Win32_DeviceSettings
{
  Win32_NetworkAdapterConfiguration REF Setting;
  Win32_NetworkAdapter              REF Element;
};

Members

The Win32_NetworkAdapterSetting class has these types of members:

Properties

Properties

The Win32_NetworkAdapterSetting class has these properties.

Element

Data type: Win32_NetworkAdapter
Access type: Read-only
Qualifiers: Override ("Element"), MappingStrings ("WMI|Win32_NetworkAdapter")

A Win32_NetworkAdapter that describes the properties of the network adapter that is using a particular network adapter setting.

Setting

Data type: Win32_NetworkAdapterConfiguration
Access type: Read-only
Qualifiers: Override ("Setting"), MappingStrings ("WMI|Win32_NetworkAdapterConfiguration")

A Win32_NetworkAdapterConfiguration that describes the configuration settings used on the network adapter.

Remarks

The Win32_NetworkAdapterSetting class is derived from Win32_DeviceSettings.

For information on how to use association classes, see ASSOCIATORS OF Statement.

Examples

The following VBScript sample uses Win32_NetworkAdapterSetting to identify the IP Address on the Local Area Connection.

strComputer = "."
Set objWMIService = GetObject( _
    "winmgmts:\\" & strComputer & "\root\cimv2")
Set colNics = objWMIService.ExecQuery _
    ("Select * From Win32_NetworkAdapter " _
        & "Where NetConnectionID = " & _
        "'Local Area Connection'")
 
For Each objNic in colNics
    Set colNicConfigs = objWMIService.ExecQuery _
      ("ASSOCIATORS OF " _
          & "{Win32_NetworkAdapter.DeviceID='" & _
      objNic.DeviceID & "'}" & _
      " WHERE AssocClass=Win32_NetworkAdapterSetting")
    For Each objNicConfig In colNicConfigs
        For Each strIPAddress in objNicConfig.IPAddress
            Wscript.Echo "IP Address: " &  strIPAddress
        Next
    Next
Next

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll