Win32_NetworkAdapter 类
Win32_NetworkAdapter 类已弃用。 请改用 MSFT_NetAdapter 类。 Win32_NetworkAdapterWMI 类表示运行 Windows 操作系统的计算机的网络适配器。
Win32_NetworkAdapter 仅提供 IPv4 数据。 有关详细信息，请参阅 WMI 中的 IPv6 和 IPv4 支持。
以下语法从托管对象格式 (MOF) 代码中简化，包括所有继承的属性。 属性按字母顺序列出，而不是按 MOF 顺序列出。
语法
[Dynamic, Provider("CIMWin32"), UUID("{8502C4C0-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_NetworkAdapter : CIM_NetworkAdapter
{
string AdapterType;
uint16 AdapterTypeID;
boolean AutoSense;
uint16 Availability;
string Caption;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
string Description;
string DeviceID;
boolean ErrorCleared;
string ErrorDescription;
string GUID;
uint32 Index;
datetime InstallDate;
boolean Installed;
uint32 InterfaceIndex;
uint32 LastErrorCode;
string MACAddress;
string Manufacturer;
uint32 MaxNumberControlled;
uint64 MaxSpeed;
string Name;
string NetConnectionID;
uint16 NetConnectionStatus;
boolean NetEnabled;
string NetworkAddresses[];
string PermanentAddress;
boolean PhysicalAdapter;
string PNPDeviceID;
uint16 PowerManagementCapabilities[];
boolean PowerManagementSupported;
string ProductName;
string ServiceName;
uint64 Speed;
string Status;
uint16 StatusInfo;
string SystemCreationClassName;
string SystemName;
datetime TimeOfLastReset;
};
成员
Win32_NetworkAdapter 类具有以下类型的成员：
方法
Win32_NetworkAdapter 类具有这些方法。
| 方法 | 说明 |
|---|---|
| 禁用 | 禁用网络适配器。 |
| 启用 | 启用网络适配器。 |
| 重置 | 未实现。 有关如何实现此方法的详细信息，请参阅 CIM_NetworkAdapter 中的 Reset 方法。 |
| SetPowerState | 未实现。 有关如何实现此方法的详细信息，请参阅 CIM_NetworkAdapter 中的 SetPowerState 方法。 |
属性
Win32_NetworkAdapter 类具有这些属性。
-
AdapterType
-
-
数据类型： string
-
访问类型：只读
-
限定符： MappingStrings (“DeviceIoControl：：OID_GEN_MEDIA_IN_USE”)
正在使用的网络介质。 网络适配器如下所示：
-
-
以太网 802.3 (“以太网 802.3”)
-
Token Ring 802.5 (“Token Ring 802.5”)
-
光纤分布式数据接口 (FDDI) (“光纤分布式数据接口 (FDDI) ”)
-
广域网 (WAN) (“广域网 (WAN) ”)
-
LocalTalk (“LocalTalk”)
-
使用 DIX 标头格式的以太网 (“使用 DIX 标头格式的以太网”)
-
ARCNET (“ARCNET”)
-
ARCNET (878.2) (“ARCNET (878.2) ”)
-
ATM (“ATM”)
-
无线 (“无线”)
-
红外无线 (“红外无线”)
-
Bpc (“Bpc”)
-
CoWan (“CoWan”)
-
1394 (“1394”)
AdapterTypeID
-
数据类型： uint16
-
访问类型：只读
-
限定符： MappingStrings (“DeviceIoControl：：OID_GEN_MEDIA_IN_USE”)
正在使用的网络介质。 返回与 AdapterType 属性相同的信息，只不过信息采用整数的形式。
以太网 802.3 (0)
Token Ring 802.5 (1)
光纤分布式数据接口 (FDDI) (2)
广域网 (WAN) (3)
LocalTalk (4)
使用 DIX 标头格式的以太网 (5)
ARCNET (6)
ARCNET (878.2) (7)
ATM (8)
无线 (9)
红外无线 (10)
Bpc (11)
CoWan (12)
1394 (13)
AutoSense
-
数据类型： 布尔值
-
访问类型：只读
如果 为 True，网络适配器可以自动确定附加媒体或网络媒体的速度。
此属性继承自 CIM_NetworkAdapter。
此属性尚未实现。 默认情况下，它返回 NULL 值。
可用性
-
数据类型： uint16
-
访问类型：只读
-
限定符： MappingStrings (“MIF”。DMTF |操作状态|003.5“，”MIB。IETF |HOST-RESOURCES-MIB.hrDeviceStatus“)
设备的可用性和状态。
此属性继承自 CIM_LogicalDevice。
其他 (1)
未知 (2)
运行/全功率 (3)
运行或全功率
警告 (4)
在测试 (5)
不适用 (6)
关机 (7)
下线 (8)
下班 (9)
降级 (10)
未安装 (11)
安装错误 (12)
节能 - 未知 (13)
已知设备处于省电状态，但其确切状态未知。
节能 - 低功耗模式 (14)
设备处于省电状态，但仍能正常工作，性能可能会下降。
省电 - 待机 (15)
设备无法正常工作，但可以快速通电。
电源周期 (16)
节电 - 警告 (17)
设备处于警告状态，但也处于省电状态。
暂停 (18)
设备已暂停。
未就绪 (19)
设备未准备就绪。
未配置 (20)
设备未配置。
静止 (21)
设备安静。
Caption
-
数据类型： 字符串
-
访问类型：只读
-
限定符： MaxLen (64) 、 DisplayName (“Caption”)
对象的简短说明 - 单行字符串。
此属性继承自 CIM_ManagedSystemElement。
ConfigManagerErrorCode
-
数据类型： uint32
-
访问类型：只读
-
限定符： 架构 (“Win32”)
Windows Configuration Manager错误代码。
此属性继承自 CIM_LogicalDevice。
此设备工作正常。 (0)
设备工作正常。
此设备配置不正确。 (1)
设备配置不正确。
Windows 无法加载此设备的驱动程序。 (2)
此设备的驱动程序可能已损坏，或者系统的内存或其他资源可能运行不足。 (3)
此设备的驱动程序可能已损坏，或者系统内存或其他资源可能不足。
此设备无法正常工作。其中一个驱动程序或注册表可能已损坏。 (4)
设备无法正常工作。 其中一个驱动程序或注册表可能已损坏。
此设备的驱动程序需要 Windows 无法管理的资源。 (5)
设备的驱动程序需要 Windows 无法管理的资源。
此设备的启动配置与其他设备冲突。 (6)
设备的启动配置与其他设备冲突。
无法筛选。 (7)
缺少设备的驱动程序加载程序。 (8)
缺少设备的驱动程序加载程序。
此设备无法正常工作，因为控制固件错误地报告设备的资源。 (9)
设备无法正常工作。 控制固件错误地报告了设备的资源。
此设备无法启动。 (10)
设备无法启动。
此设备失败。 (11)
设备失败。
此设备找不到可以使用的足够可用资源。 (12)
设备找不到足够的可用资源来使用。
Windows 无法验证此设备的资源。 (13)
Windows 无法验证设备的资源。
在重启计算机之前，此设备无法正常工作。 (14)
在重启计算机之前，设备无法正常工作。
此设备无法正常工作，因为可能存在重新枚举问题。 (15)
设备由于可能的重新枚举问题而无法正常工作。
Windows 无法识别此设备使用的所有资源。 (16)
Windows 无法识别设备使用的所有资源。
此设备请求未知资源类型。 (17)
设备正在请求未知资源类型。
重新安装此设备的驱动程序。 (18)
必须重新安装设备驱动程序。
使用 VxD 加载程序失败。 (19)
注册表可能已损坏。 (20)
注册表可能已损坏。
系统故障：尝试更改此设备的驱动程序。如果这不起作用，请参阅硬件文档。Windows 正在删除此设备。 (21)
系统故障。 如果更改设备驱动程序无效，请参阅硬件文档。 Windows 正在删除设备。
此设备已禁用。 (22)
设备已禁用。
系统故障：尝试更改此设备的驱动程序。如果这不起作用，请参阅硬件文档。 (23)
系统故障。 如果更改设备驱动程序无效，请参阅硬件文档。
此设备不存在、工作不正常或未安装其所有驱动程序。 (24)
设备不存在、工作不正常或未安装其所有驱动程序。
Windows 仍在设置此设备。 (25)
Windows 仍在设置设备。
Windows 仍在设置此设备。 (26)
Windows 仍在设置设备。
此设备没有有效的日志配置。 (27)
设备没有有效的日志配置。
未安装此设备的驱动程序。 (28)
未安装设备驱动程序。
此设备处于禁用状态，因为设备的固件未为其提供所需的资源。 (29)
设备已禁用。 设备固件未提供所需的资源。
此设备使用另一个设备正在使用的中断请求 (IRQ) 资源。 (30)
设备正在使用另一个设备正在使用的 IRQ 资源。
此设备无法正常工作，因为 Windows 无法加载此设备所需的驱动程序。 (31)
设备无法正常工作。 Windows 无法加载所需的设备驱动程序。
ConfigManagerUserConfig
-
数据类型： 布尔值
-
访问类型：只读
-
限定符： 架构 (“Win32”)
如果 为 True，则设备使用的是用户定义的配置。
此属性继承自 CIM_LogicalDevice。
CreationClassName
-
数据类型： string
-
访问类型：只读
-
限定符： CIM_Key
在创建实例时使用的继承链中显示的第一个具体类的名称。 与 类的其他键属性一起使用时， 属性允许对此类及其子类的所有实例进行唯一标识。
此属性继承自 CIM_LogicalDevice。
描述
-
数据类型： string
-
访问类型：只读
-
限定符： DisplayName (“Description”)
对象的说明。
此属性继承自 CIM_ManagedSystemElement。
DeviceID
-
数据类型： string
-
访问类型：只读
-
限定符： Key、 Override (“DeviceId”) 、 MappingStrings (“Win32Registry|System\\CurrentControlSet\\Control\\Class\\{4D36E972-E325-11CE-BFC1-08002BE10318}“)
来自系统上其他设备的网络适配器的唯一标识符。
此属性继承自 CIM_LogicalDevice。
ErrorCleared
-
数据类型： 布尔值
-
访问类型：只读
如果 为 True，则现在清除 LastErrorCode 中报告的错误。
此属性继承自 CIM_LogicalDevice。
ErrorDescription
-
数据类型： string
-
访问类型：只读
有关 LastErrorCode 中记录的错误的详细信息，以及有关可能采取的任何纠正措施的信息。
此属性继承自 CIM_LogicalDevice。
GUID
-
数据类型： string
-
访问类型：只读
连接的全局唯一标识符。
Index
-
数据类型： uint32
-
访问类型：只读
-
限定符： MappingStrings (“Win32Registry|System\\CurrentControlSet\\Control\\Class\\{4D36E972-E325-11CE-BFC1-08002BE10318}“)
存储在系统注册表中的网络适配器的索引号。
示例：0
InstallDate
-
数据类型： datetime
-
访问类型：只读
-
限定符： MappingStrings (“MIF”。DMTF |ComponentID|001.5“) ， DisplayName (”安装日期“)
对象的安装日期和时间。 此属性不需要值来指示已安装对象。
此属性继承自 CIM_ManagedSystemElement。
此属性尚未实现。 默认情况下，它返回 NULL 值。
已安装
-
数据类型： 布尔值
-
访问类型：只读
-
限定符：已弃用，MappingStrings (“Win32Registry|Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards|DriverDate“)
如果 为 True，则网络适配器安装在系统中。
InterfaceIndex
-
数据类型： uint32
-
访问类型：只读
唯一标识本地网络接口的索引值。 此属性中的值与表示路由表中网络接口的 Win32_IP4RouteTable 实例中的 InterfaceIndex 属性中的值相同。
LastErrorCode
-
数据类型： uint32
-
访问类型：只读
逻辑设备报告的最后一个错误代码。
此属性继承自 CIM_LogicalDevice。
MACAddress
-
数据类型： string
-
访问类型：只读
-
限定符： MappingStrings (“Win32API|设备输入和输出函数 |DeviceIoControl“)
此网络适配器的媒体访问控制地址。 MAC 地址是由制造商分配给网络适配器的唯一 48 位号码。 它唯一标识此网络适配器，用于映射 TCP/IP 网络通信。
Manufacturer
-
数据类型： string
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards|Manufacturer“)
网络适配器的制造商的名称。
示例：“3COM”
MaxNumberControlled
-
数据类型： uint32
-
访问类型：只读
-
限定符： MappingStrings (“MIF”。DMTF |总线端口|001.9|最大附件数“)
此网络适配器支持的直接可寻址端口的最大数目。 如果数字未知，则应使用值 0 (零) 。
MaxSpeed
-
数据类型： uint64
-
访问类型：只读
-
限定符： 单位 (“每秒位数”)
网络适配器的最大速度（以位数/秒为单位）。
此属性继承自 CIM_NetworkAdapter。
此属性尚未实现。 默认情况下，它返回 NULL 值。
有关在脚本中使用 uint64 值的详细信息，请参阅 WMI 中的脚本。
名称
-
数据类型： string
-
访问类型：只读
-
限定符： DisplayName (“Name”)
对象的已知标签。 子类化后，属性可以重写为键属性。
此属性继承自 CIM_ManagedSystemElement。
NetConnectionID
-
数据类型： string
-
访问类型：读/写
网络连接控制面板程序中显示的网络连接的名称。
NetConnectionStatus
-
数据类型： uint16
-
访问类型：只读
网络适配器连接到网络的状态。
断开连接 (0)
连接 (1)
连接的 (2)
断开连接 (3)
硬件不存在 (4)
硬件禁用 (5)
硬件故障 (6)
媒体断开连接 (7)
对 (8) 进行身份验证
身份验证成功 (9)
身份验证失败 (10)
地址 (11) 无效
所需的凭据 (12)
其他
NetEnabled
-
数据类型： 布尔值
-
访问类型：只读
指示适配器是否已启用。 如果 为 True，则启用适配器。 可以使用 Enable 和 Disable方法启用或禁用 NIC。
NetworkAddresses
-
数据类型： 字符串 数组
-
访问类型：只读
-
限定符： MaxLen (64) ， MappingStrings (“MIF。DMTF |网络适配器 802 端口|001.3“)
适配器的网络地址数组。
此属性继承自 CIM_NetworkAdapter。
此属性尚未实现。 默认情况下，它返回 NULL 值。
PermanentAddress
-
数据类型： 字符串
-
访问类型：只读
-
限定符： MaxLen (64) ， MappingStrings (“MIF。DMTF |网络适配器 802 端口|001.2“)
硬编码为适配器的网络地址。 可以通过固件升级或软件配置更改此硬编码地址。 如果是这样，则应在进行更改时更新此字段。 如果网络适配器没有硬编码地址，则 属性应留空。
此属性继承自 CIM_NetworkAdapter。
此属性尚未实现。 默认情况下，它返回 NULL 值。
PhysicalAdapter
-
数据类型： 布尔值
-
访问类型：只读
指示适配器是物理适配器还是逻辑适配器。 如果 为 True，则适配器为物理适配器。
PNPDeviceID
-
数据类型： 字符串
-
访问类型：只读
-
限定符： 架构 (“Win32”)
Windows 即插即用逻辑设备的设备标识符。
此属性继承自 CIM_LogicalDevice。
示例：“*PNP030b”
PowerManagementCapabilities
-
数据类型： uint16 数组
-
访问类型：只读
逻辑设备的特定电源相关功能的数组。
此属性继承自 CIM_LogicalDevice。
未知 (0)
不支持 (1)
禁用 (2)
已启用 (3)
电源管理功能当前已启用，但确切功能集未知或信息不可用。
自动进入节能模式 (4)
设备可以根据使用情况或其他条件更改其电源状态。
Power State Settable (5)
支持 SetPowerState 方法。 此方法在父 CIM_LogicalDevice 类上找到，可以实现。 有关详细信息，请参阅 设计托管对象格式 (MOF) 类。
支持电源循环 (6)
可以在 PowerState 参数设置为 5 的情况下调用 SetPowerState 方法， (Power Cycle) 。
支持计时开机 (7)
支持计时Power-On
可以使用 PowerState 参数设置为 5 (Power Cycle) 和时间设置为开机的特定日期和时间或间隔来调用 SetPowerState 方法。
PowerManagementSupported
-
数据类型： 布尔值
-
访问类型：只读
如果 为 True，则设备可以进行电源管理 (可以置于挂起模式，依此) 。 属性并不指示当前已启用电源管理功能，仅指示逻辑设备能够进行电源管理。
此属性继承自 CIM_LogicalDevice。
ProductName
-
数据类型： 字符串
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards|ServiceName“)
网络适配器的产品名称。
示例：“Fast EtherLink XL”
ServiceName
-
数据类型： 字符串
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards|ProductName“)
网络适配器的服务名称。 此名称通常比完整产品名称短。
示例：“Elnkii”
速度
-
数据类型： uint64
-
访问类型：只读
-
限定符： MappingStrings (“MIB”。IETF |RFC1213-MIB.ifSpeed“、”MIF.DMTF |网络适配器 802 端口|001.5“) ， 单位 (”每秒位数“)
估计当前带宽（以位/秒为单位）。 对于带宽不同或无法进行准确估计的终结点，此属性应包含名义带宽。
此属性继承自 CIM_NetworkAdapter。
有关在脚本中使用 uint64 值的详细信息，请参阅 在 WMI 中编写脚本。
Status
-
数据类型： 字符串
-
访问类型：只读
-
限定符： MaxLen (10) 、 DisplayName (“Status”)
对象的当前状态。 此属性继承自 CIM_ManagedSystemElement。
包括以下值：
OK (“OK”)
错误 (“错误”)
降级 (“已降级”)
未知 (“未知”)
Pred Fail (“Pred Fail”)
starting (“Starting”)
停止 (“停止”)
服务 (“服务”)
压力 (“有压力”)
NonRecover (“NonRecover”)
无联系人 (“无联系人”)
Lost Comm (“Lost Comm”)
StatusInfo
-
数据类型： uint16
-
访问类型：只读
-
限定符： MappingStrings (“MIF”。DMTF |操作状态|003.3“)
逻辑设备的状态。 如果此属性不适用于逻辑设备，则应使用值 5 (不适用) 。
此属性继承自 CIM_LogicalDevice。
其他 (1)
未知 (2)
已启用 (3)
禁用 (4)
不适用 (5)
SystemCreationClassName
-
数据类型： 字符串
-
访问类型：只读
-
限定符： 传播 (“CIM_System。CreationClassName“) ， CIM_Key
范围计算机的 CreationClassName 属性的值。
此属性继承自 CIM_LogicalDevice。
SystemName
-
数据类型： 字符串
-
访问类型：只读
-
限定符： 传播 (“CIM_System。Name“) ， CIM_Key
范围系统的名称。
此属性继承自 CIM_LogicalDevice。
TimeOfLastReset
-
数据类型： datetime
-
访问类型：只读
-
限定符：MappingStrings (“SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Perflib\\\009|系统启动时间“)
上次重置网络适配器的日期和时间。
备注
Win32_NetworkAdapter 类派生自 CIM_NetworkAdapter。
以下列表描述了 Win32_NetworkAdapter的 Associator 类：
- Win32_PnPEntity
- Win32_ComputerSystem
- Win32_NetworkAdapterConfiguration
- Win32_IRQResource
- Win32_DeviceMemoryAddress
- Win32_PortResource
- Win32_NetworkProtocol
- Win32_SystemDriver
许多系统都有许多网络适配器。 请考虑使用以下内容作为引用来查找当前适配器：
AdapterType: "Ethernet 802.3"
MACAddress: String Length > 16
Availability: 3
PNPDeviceID: InStr ( PNPDeviceID, "PCI") = 1
Installed: vbTrue
ConfigManagerErrorCode: 0
: <keep this as an index to Win32_NetworkAdapterConfiguration>
即使使用上述限定符，也可能会检索多个有效的网络适配器。 如果是这种情况，则可以使用以下信息进一步限定对Win32_NetworkAdapterConfiguration的搜索：
Index: <match to DeviceID above>
MACAddress: Length > 16
DefaultIPGateway: String Length > 6
DNSServerSearchOrder: Array of strings with length > 6
IPEnabled: vbTrue
IPAddress: Array of strings with length > 6
执行此操作后，可能会将列表减少到一个或两个已配置的适配器。
还可以使用以下过程来查找默认适配器：
运行以下查询：
"SELECT InterfaceIndex, Destination FROM Win32_IP4RouteTable WHERE Destination='0.0.0.0'"应只有一个默认网络目标 0.0.0.0。
使用 InterfaceIndex 检索所需的网络适配器。
"SELECT * FROM Win32_NetworkAdapter WHERE InterfaceIndex=" + insertVariableHere
示例
TechNet 库中的 两个 WMI Functions PowerShell 代码示例使用 Win32_NetworkAdapter 重新创建 Windows Get-NetAdapter cmdlet。
TechNet 库中的 Get-ComputerInfo - 从本地/远程计算机查询计算机信息 - (WMI) PowerShell 示例使用大量对硬件和软件的调用（包括 Win32_NetworkAdapter）来显示有关本地或远程系统的信息。
以下 C# 代码示例使用 Microsoft.Management.Infrastructure 命名空间检索本地计算机上的当前网络适配器。
using Microsoft.Management.Infrastructure;
...
static void QueryInstanceFunc()
{
CimSession session = CimSession.Create("localHost");
IEnumerable<CimInstance> queryInstance = session.QueryInstances(@"root\cimv2", "WQL", "SELECT * FROM Win32_NetworkAdapter");
foreach (CimInstance cimObj in queryInstance)
{
Console.WriteLine(cimObj.CimInstanceProperties["Name"].ToString());
Console.WriteLine(cimObj.CimInstanceProperties["Description"].ToString());
Console.WriteLine();
}
Console.ReadLine();
}
以下 C# 代码示例使用 https://msdn.microsoft.com/library/system.management.aspx 命名空间检索本地计算机上的当前网络适配器。
注意
https://msdn.microsoft.com/library/system.management.aspx 包含用于访问 WMI 的原始类;但是，它们被视为速度较慢，并且通常无法缩放，以及其 Microsoft.Management.Infrastructure 对应项。
using System.Management;
...
static void oldSchoolQueryInstanceFunc()
{
ObjectQuery query = new ObjectQuery("SELECT * FROM Win32_NetworkAdapter");
ManagementObjectSearcher searcher = new ManagementObjectSearcher(query);
ManagementObjectCollection queryCollection = searcher.Get();
foreach (ManagementObject m in queryCollection)
{
Console.WriteLine("ServiceName : {0}", m["Name"]);
Console.WriteLine("MACAddress : {0}", m["Description"]);
Console.WriteLine();
}
Console.ReadLine();
}
以下 VBScript 代码示例介绍如何检索本地计算机上的当前网络适配器。
strComputer = "."
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\CIMV2")
Set colItems = objWMIService.ExecQuery("SELECT * FROM Win32_NetworkAdapter")
For Each objItem in colItems
Wscript.Echo "Name: " & objItem.Name
Wscript.Echo "Description: " & objItem.Description
Wscript.Echo
Next
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista |
| 最低受支持的服务器 |
Windows Server 2008 |
| 命名空间 |
Root\CIMV2 |
| MOF |
|
| DLL |
|
另请参阅