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
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 |
See also
Computer System Hardware Classes
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
