MSFT_NetAdapter 类

2025-03-11

逻辑网络适配器

以下语法从托管对象格式 (MOF) 代码中简化，包括所有继承的属性。

语法

[Dynamic, Provider("NetAdapterCim")]
class MSFT_NetAdapter : CIM_NetworkPort
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  uint16   Availability;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  uint32   LastErrorCode;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
  uint64   Speed;
  uint64   MaxSpeed;
  uint64   RequestedSpeed;
  uint16   UsageRestriction;
  uint16   PortType;
  string   OtherPortType;
  string   OtherNetworkPortType;
  uint16   PortNumber;
  uint16   LinkTechnology;
  string   OtherLinkTechnology;
  string   PermanentAddress;
  string   NetworkAddresses[];
  boolean  FullDuplex;
  boolean  AutoSense;
  uint64   SupportedMaximumTransmissionUnit;
  uint64   ActiveMaximumTransmissionUnit;
  string   InterfaceDescription;
  string   InterfaceName;
  uint64   NetLuid;
  string   InterfaceGuid;
  uint32   InterfaceIndex;
  string   DeviceName;
  uint32   NetLuidIndex;
  boolean  Virtual;
  boolean  Hidden;
  boolean  NotUserRemovable;
  boolean  IMFilter;
  uint32   InterfaceType;
  boolean  HardwareInterface;
  boolean  WdmInterface;
  boolean  EndPointInterface;
  boolean  iSCSIInterface;
  uint32   State;
  uint32   NdisMedium;
  uint32   NdisPhysicalMedium;
  uint32   InterfaceOperationalStatus;
  boolean  OperationalStatusDownDefaultPortNotAuthenticated;
  boolean  OperationalStatusDownMediaDisconnected;
  boolean  OperationalStatusDownInterfacePaused;
  boolean  OperationalStatusDownLowPowerState;
  uint32   InterfaceAdminStatus;
  uint32   MediaConnectState;
  uint32   MtuSize;
  uint16   VlanID;
  uint64   TransmitLinkSpeed;
  uint64   ReceiveLinkSpeed;
  boolean  PromiscuousMode;
  boolean  DeviceWakeUpEnable;
  boolean  ConnectorPresent;
  uint32   MediaDuplexState;
  string   DriverDate;
  uint64   DriverDateData;
  string   DriverVersionString;
  string   DriverName;
  string   DriverDescription;
  uint16   MajorDriverVersion;
  uint16   MinorDriverVersion;
  uint8    DriverMajorNdisVersion;
  uint8    DriverMinorNdisVersion;
  string   PnPDeviceID;
  string   DriverProvider;
  string   ComponentID;
  uint32   LowerLayerInterfaceIndices[];
  uint32   HigherLayerInterfaceIndices[];
  boolean  AdminLocked;
};

成员

MSFT_NetAdapter 类具有以下类型的成员：

方法
属性

方法

MSFT_NetAdapter 类具有这些方法。

方法	说明
禁用	禁用网络适配器。
启用	启用网络适配器。
锁定	锁定网络适配器。
重命名	重命名网络适配器。
重启	重启网络适配器。
Unlock	解除锁定网络适配器。

属性

MSFT_NetAdapter 类具有以下属性。

ActiveMaximumTransmissionUnit

数据类型：uint64
访问类型：只读
限定符：Units（“字节”）

可以支持的活动或协商的最大传输单元 (MTU)。此属性继承自 CIM_NetworkPort。

AdminLocked

数据类型：布尔
访问类型：只读

网络适配器的管理状态。如果为 True，则网络适配器处于锁定状态，除非该适配器已解锁，否则许多属性无法更改。

AutoSense

数据类型：布尔
访问类型：只读

一个布尔值，指示网络端口是否能够自动确定连接的网络媒体的速度或其他通信特征。此属性继承自 CIM_NetworkPort。

可用性

数据类型：uint16
访问类型：只读

设备的可用性和状态。此属性继承自 CIM_LogicalDevice。

值	含义
其他 1 (0x1)
未知 2 (0x2)
正在运行/全功率 3 (0x3)
警告 4 (0x4)
测试中 5 (0x5)
不适用 6 (0x6)
关闭电源 7 (0x7)
脱机 8 (0x8)
下班 9 (0x9)
已降级 10 (0xA)
未安装 11 (0xB)
安装错误 12 (0xC)
省电 - 未知 13 (0xD)	已知设备处于省电模式，但其确切状态未知。
省电 - 低功率模式 14 (0xE)	设备处于省电状态，但仍正常运行，并可能表现出性能下降。
省电 - 待机 15 (0xF)	设备不在正常运行，但可以快速进入全功率。
电源周期 16 (0x10)
省电 - 警告 17 (0x11)	设备处于警告状态，但也处于省电模式。

Caption

数据类型：字符串
访问类型：只读

对象的简短文本描述。此属性继承自 CIM_ManagedElement。

ComponentID

数据类型：字符串
访问类型：只读

PnP 组件 ID，也称为网络适配器的硬件 ID。

ConfigManagerErrorCode

数据类型：uint32
访问类型：只读

Win32 Configuration Manager 错误代码。此属性继承自 CIM_LogicalDevice。

值	含义
0 (0x0)	设备在正常工作。
1 (0x1)	此设备配置不正确。
2 (0x2)	Windows 无法为此设备加载该驱动程序。
3 (0x3)	此设备的驱动程序可能已损坏，或者系统内存不足或其他资源不足。
4 (0x4)	设备未在正常工作。它的一个驱动程序或注册表可能已损坏。
5 (0x5)	此设备的驱动程序需要 Windows 无法管理的资源。
6 (0x6)	设备的启动配置与其他设备冲突。
7 (0x7)	无法筛选。
8 (0x8)	缺少设备的驱动程序加载程序。
9 (0x9)	设备未在正常工作，因为控制固件对设备资源的报告不正确。
10 (0xA)	设备无法启动。
11 (0xB)	设备失败。
12 (0xC)	设备找不到足够可用的资源。
13 (0xD)	Windows 无法验证设备的资源。
14 (0xE)	重启计算机之前，设备无法正常工作。
15 (0xF)	由于可能的重新枚举问题，设备无法正常工作。
16 (0x10)	Windows 无法标识设备使用的全部资源。
17 (0x11)	设备正在请求未知的资源类型。
18 (0x12)	必须重新安装设备驱动程序。
19 (0x13)	使用 VxD 加载程序失败。
20 (0x14)	注册表可能已损坏。
21 (0x15)	系统失败。如果更改设备驱动程序无效，请参阅硬件文档。 Windows 正在移除设备。
22 (0x16)	设备已被禁用。
23 (0x17)	系统失败。如果更改设备驱动程序无效，请参阅硬件文档。
24 (0x18)	设备不存在、运行不正确、或者没有安装所有的驱动程序。
25 (0x19)	Windows 仍在设置设备。
26 (0x1A)	Windows 仍在设置设备。
27 (0x1B)	设备没有有效的日志配置。
28 (0x1C)	未安装设备驱动程序。
29 (0x1D)	设备已禁用，设备固件未提供所需的资源。
30 (0x1E)	设备正在使用另一个设备在使用的 IRQ 资源。
31 (0x1F)	设备未在正常工作，因为 Windows 无法加载此设备所需的驱动程序。

ConfigManagerUserConfig

数据类型：布尔
访问类型：只读

如果为 True，则设备在使用用户定义的配置。此属性继承自 CIM_LogicalDevice。

ConnectorPresent

数据类型：布尔
访问类型：只读

指示网络适配器上是否存在连接器。如果它是物理适配器，则此值设置为 TRUE，如果它不是物理适配器，则此值设置为 FALSE。

CreationClassName

数据类型：字符串
访问类型：只读

在创建实例时使用的类或子类的名称。与类的其他键属性一起使用时，此属性允许唯一标识此类及其子类的所有实例。此属性继承自 CIM_LogicalDevice。

描述

数据类型：字符串
访问类型：只读

对象的文本说明。此属性继承自 CIM_ManagedElement。

DeviceID

数据类型：字符串
访问类型：只读

用于为逻辑设备指定唯一名称的地址或其他标识信息。此属性继承自 CIM_LogicalDevice。

设备名称

数据类型：字符串
访问类型：只读

此适配器的设备对象的名称。

DeviceWakeUpEnable

数据类型：布尔
访问类型：只读

如果网络适配器支持 LAN 唤醒功能，并且已启用该功能，则为 TRUE；否则为 FALSE。

DriverDate

数据类型：字符串
访问类型：只读

YYYY-MM-DD 格式的网络适配器驱动程序日期。

DriverDateData

数据类型：uint64
访问类型：只读

FILETIME 格式的网络适配器驱动程序日期。它是一个 64 位值，表示从 1601 年 1 月 1 日 (UTC) 起长度为 100 纳秒的间隔的数量。

Driverdescription

数据类型：字符串
访问类型：只读

网络适配器驱动程序的说明。

DriverMajorNdisVersion

数据类型：uint8
访问类型：只读

网络适配器驱动程序符合的主要 NDIS 版本。

DriverMinorNdisVersion

数据类型：uint8
访问类型：只读

网络适配器驱动程序符合的次要 NDIS 版本。

DriverName

数据类型：字符串
访问类型：只读

网络适配器驱动程序的名称。

DriverProvider

数据类型：字符串
访问类型：只读

驱动程序提供程序名称。

DriverVersionString

数据类型：字符串
访问类型：只读

表示网络适配器驱动程序版本的字符串。

EndPointInterface

数据类型：布尔
访问类型：只读

此接口是终结点设备，而不是连接到网络的实际网络接口。

ErrorCleared

数据类型：布尔
访问类型：只读

如果为 True，则会立即清除在 LastErrorCode 属性中报告的错误。此属性继承自 CIM_LogicalDevice。

ErrorDescription

数据类型：字符串
访问类型：只读

自由格式字符串，提供有关在 LastErrorCode 属性中记录的错误以及要执行的纠正措施的信息。此属性继承自 CIM_LogicalDevice。

FullDuplex

数据类型：布尔
访问类型：只读

一个布尔值，指示端口是否在全双工模式下运行。此属性继承自 CIM_NetworkPort。

HardwareInterface

数据类型：布尔
访问类型：只读

网络适配器的接口由硬件设备提供。

Hidden

数据类型：布尔
访问类型：只读

网络适配器处于隐藏状态，不显示在任何用户界面中。

HigherLayerInterfaceIndices

数据类型：uint32 数组
访问类型：只读

较高层接口的接口索引。

IMFilter

数据类型：布尔
访问类型：只读

网络适配器是中间滤波器组件的适配器边缘。

InstallDate

数据类型：datetime
访问类型：只读

对象的安装日期和时间。此属性不需要值来指示对象已安装。此属性继承自 CIM_ManagedSystemElement。

InterfaceAdminStatus

数据类型：uint32
访问类型：只读

网络适配器管理状态，如 RFC 2863 中所述。

工作 (1)
关闭 (2)
测试 (3)

InterfaceDescription

数据类型：字符串
访问类型：只读

接口说明（也称为“ifDesc”或显示名称）是在安装过程中分配给网络适配器的唯一名称。此名称无法更改，只要没有卸载网络适配器，就会持久使用。

InterfaceGuid

数据类型：字符串
访问类型：只读

网络接口的 GUID。

InterfaceIndex

数据类型：uint32
访问类型：只读

标识网络接口的索引。当禁用和启用网络适配器时，此索引值可能更改，不应被视为持久使用的。

InterfaceName

数据类型：字符串
访问类型：只读

网络接口的本地唯一标识符。其格式为 InterfaceType_NetluidIndex。例如：Ethernet_2。

InterfaceOperationalStatus

数据类型：uint32
访问类型：只读

当前网络接口工作状态。

工作 (1)
关闭 (2)
测试 (3)
未知 (4)
休眠 (5)
不存在 (6)
低层关闭 (7)

InterfaceType

数据类型：uint32
访问类型：只读

互联网名称分配机构 (IANA) 定义的接口类型。

iSCSIInterface

数据类型：布尔
访问类型：只读

接口由 iSCSI Software Initiator 使用，位于分页路径中。

LastErrorCode

数据类型：uint32
访问类型：只读

逻辑设备报告的最后一个错误代码。此属性继承自 CIM_LogicalDevice。

LinkTechnology

数据类型：uint16
访问类型：只读

链接类型的枚举。当设置为 1（“其他”）时，OtherLinkTechnology 包含链接类型的字符串说明。此属性继承自 CIM_NetworkPort。

未知 (0)
其他 (1)
以太网 (2)
IB (3)
FC (4)
FDDI (5)
ATM (6)
令牌环 (7)
帧中继 (8)
红外线 (9)
蓝牙 (10)
无线 LAN (11)

LowerLayerInterfaceIndices

数据类型：uint32 数组
访问类型：只读

较低层接口的接口索引。

MajorDriverVersion

数据类型：uint16
访问类型：只读

网络适配器驱动程序的主要版本。

MaxSpeed

数据类型：uint64
访问类型：只读
限定符：Units（“位每秒”）

端口的最大带宽（以 bps 为单位）。此属性继承自 CIM_LogicalPort。

MediaConnectState

数据类型：uint32
访问类型：只读

指定网络适配器连接状态。

未知 (0)
已连接 (1)
已断开连接 (2)

MediaDuplexState

数据类型：uint32
访问类型：只读

网络适配器的媒体双工状态。

MinorDriverVersion

数据类型：uint16
访问类型：只读

网络适配器驱动程序的次要版本。

MtuSize

数据类型：uint32
访问类型：只读

网络适配器支持的最大传输单位 (MTU) 大小。此值不包括链接层标头的大小。

Name

数据类型：字符串
访问类型：只读

作为知晓对象的依据的标签。在子类化时，此属性可被替代为键属性。此属性继承自 CIM_ManagedSystemElement。

NdisMedium

数据类型：uint32
访问类型：只读

网络适配器媒体类型。

802.3 (0)
802.5 (1)
FDDI (2)
WAN (3)
本地谈话 (4)
DIX (5)
原始 Arcnet (6)
878.2 (7)
ATM (8)
无线 WAN (9)
IRDA (10)
BPC (11)
面向连接的 WAN (12)
IP 1394 (13)
IB (14)
隧道 (15)
本机 802.11 (16)
环回 (17)
WiMAX (18)
IP (19)

NdisPhysicalMedium

数据类型：uint32
访问类型：只读

网络适配器支持的物理媒体的类型。

未指定 (0)
无线 LAN (1)
电缆调制解调器 (2)
电话线 (3)
电源线 (4)
DSL (5)
FC (6)
1394 (7)
无线 WAN (8)
本机 802.11 (9)
蓝牙 (10)
InfiniBand (11)
WiMAX (12)
UWB (13)
802.3 (14)
802.5 (15)
IRDA (16)
有线 WAN (17)
面向有线连接的 WAN (18)
其他 (19)

NetLuid

数据类型：uint64
访问类型：只读

网络接口的本地唯一标识符 (LUID)，为 64 位数字。

NetLuidIndex

数据类型：uint32
访问类型：只读

安装时分配给网络适配器的索引。此索引在接口类型范围内是唯一的。

NetworkAddresses

数据类型：字符串数组
访问类型：只读
限定符：MaxLen (64)

标识端口的网络地址的字符串数组。此属性继承自 CIM_NetworkPort。

NotUserRemovable

数据类型：布尔
访问类型：只读

用户不能删除网络适配器。

OperationalStatusDownDefaultPortNotAuthenticated

数据类型：布尔
访问类型：只读

网络适配器的默认端口未进行身份验证。

OperationalStatusDownInterfacePaused

数据类型：布尔
访问类型：只读

网络适配器处于暂停状态。

OperationalStatusDownLowPowerState

数据类型：布尔
访问类型：只读

网络适配器处于低能耗状态。

OperationalStatusDownMediaDisconnected

数据类型：布尔
访问类型：只读

网络适配器不处于媒体连接状态。

OtherLinkTechnology

数据类型：字符串
访问类型：只读

一个字符串值，当设置为 1（“其他”）时，它描述 LinkTechnology。此属性继承自 CIM_NetworkPort。

OtherNetworkPortType

数据类型：字符串
访问类型：只读

注意：不推荐使用此属性来代替 CIM_LogicalPort.PortType 属性。已弃用的说明：当 PortType 设置为 1（“其他”）时，模块的类型。此属性继承自 CIM_NetworkPort。

OtherPortType

数据类型：字符串
访问类型：仅写入

当 PortType 设置为 1（“其他”）时，它描述模块类型。此属性继承自 CIM_LogicalPort。

PermanentAddress

数据类型：字符串
访问类型：只读
限定符：MaxLen (64)

硬编码为端口的网络地址。可以使用固件升级或软件配置，来更改此硬编码地址。进行此更改时，字段应同时更新。如果网络适配器不存在硬编码地址，PermanentAddress 应该留空。此属性继承自 CIM_NetworkPort。

PnPDeviceID

数据类型：字符串
访问类型：只读

即插即用设备 ID。

PNPDeviceID

数据类型：字符串
访问类型：只读

表示逻辑设备的 Win32 即插即用设备标识符。此属性继承自 CIM_LogicalDevice。

示例：“*PNP030b”

PortNumber

数据类型：uint16
访问类型：只读

网络端口通常相对于逻辑模块或网元进行编号。此属性继承自 CIM_NetworkPort。

PortType

数据类型：uint16
访问类型：仅写入

强制在子类中对“type”属性进行一致的命名，保证 NetworkPort 的所有实例的唯一枚举值。设置为 1（“其他”）时，相关属性 OtherPortType 包含端口类型的字符串说明。定义了系列值 DMTF_Reserved，允许子类重写和定义特定类型的端口。此属性继承自 CIM_LogicalPort。

未知 (0)
其他 (1)
不适用 (2)
DMTF 保留 (3..15999)
供应商预留 (16000..65535)

PowerManagementCapabilities

数据类型：uint16 数组
访问类型：只读

逻辑设备的电源相关特定功能的数组。此属性继承自 CIM_LogicalDevice。此属性继承自 CIM_LogicalDevice。

值	含义
未知 0 (0x0)
不支持 1 (0x1)
已禁用 2 (0x2)
已启用 3 (0x3)	电源管理功能当前已启用，但确切的功能集未知或信息不可用。
已自动进入省电模式 4 (0x4)	设备可以根据使用情况或其他条件更改其电源状态。
电源状态可设置 5 (0x5)	支持 SetPowerState 方法。此方法可在父级 CIM_LogicalDevice 类中找到，并且可以实现。有关详细信息，请参阅设计托管对象格式 (MOF) 类。
支持电源循环 6 (0x6)	在 PowerState 参数设置为 5（“电源循环”）的情况下，可以调用 SetPowerState 方法。
支持定时开机 7 (0x7)	在 PowerState 参数设置为 5（“电源循环”），Time 参数设置为开机的特定日期和时间或间隔的情况下，可以调用 SetPowerState 方法。

PowerManagementSupported

数据类型：布尔
访问类型：只读

如果为 TRUE，则设备可进行电源管理，即进入省电状态。如果为 FALSE，则整数值 1（“不支持”）应该是 PowerManagementCapabilities 数组中的唯一条目。

此属性不指示电源管理功能当前是否已启用，或在已启用的情况下，还支持哪些功能。有关详细信息，请查看 PowerManagementCapabilities 数组。

此属性继承自 CIM_LogicalDevice。

PromiscuousMode

数据类型：布尔
访问类型：只读

如果接口处于混杂模式，则为 TRUE，如果不是，则为 FALSE。

ReceiveLinkSpeed

数据类型：uint64
访问类型：只读

接收链路速度（以位每秒为单位）。

RequestedSpeed

数据类型：uint64
访问类型：仅写入
限定符：Units（“位每秒”）

端口的请求带宽（以位每秒为单位）。实际带宽在 Speed 属性中报告。此属性继承自 CIM_LogicalPort。

速度

数据类型：uint64
访问类型：只读
限定符：Units（“位每秒”）

端口的带宽（以位每秒为单位）。此属性继承自 CIM_LogicalPort。

State

数据类型：uint32
访问类型：只读

网络适配器的即插即用状态。

未知 (0)
存在 (1)
已启动 (2)
已禁用 (3)

Status

数据类型：字符串
访问类型：只读

对象的当前状态。此属性继承自 CIM_ManagedSystemElement。

包括以下值：

“确定”
“错误”
“已降级”
“未知”
“故障预警”
“正在启动”
“正在停止”
“维修”
“有压力”
“不可恢复”
“无法联系”
“通信丢失”

StatusInfo

数据类型：uint16
访问类型：只读

逻辑设备的状态。如果此属性未应用于逻辑设备，则应使用值 5（“不适用”）。此属性继承自 CIM_LogicalDevice。

其他 (1 (0x1))
未知 (2 (0x2))
已启用 (3 (0x3))
已禁用 (4 (0x4))
不适用 (5 (0x5))

SupportedMaximumTransmissionUnit

数据类型：uint64
访问类型：只读
限定符：Units（“字节”）

可支持的最大传输单元 (MTU)。此属性继承自 CIM_NetworkPort。

SystemCreationClassName

数据类型：字符串
访问类型：只读

作用域系统的创建类名。此属性继承自 CIM_LogicalDevice。

SystemName

数据类型：字符串
访问类型：只读

作用域系统的名称。此属性继承自 CIM_LogicalDevice。

TransmitLinkSpeed

数据类型：uint64
访问类型：只读

传输链路速度（以位每秒为单位）。

UsageRestriction

数据类型：uint16
访问类型：仅写入

在某些情况下，可能会将逻辑端口识别为前端或后端端口。这种情况的示例是存储数组，它可能具有与磁盘驱动器通信的后端端口和与主机通信的前端端口。如果端口的使用没有限制，则应将该值设置为“不受限制”。此属性继承自 CIM_LogicalPort。

未知 (0)
仅限前端 (2)
仅限后端 (3)
不受限制 (4)

虚拟

数据类型：布尔
访问类型：只读

网络适配器模拟了物理网卡。

VlanID

数据类型：uint16
访问类型：读/写

在网络适配器上设置的虚拟 LAN 标识符。

WdmInterface

数据类型：布尔
访问类型：只读

网络适配器的较低级别接口是 WDM 总线驱动器，如 USB。

注解

MSFT_NetAdapter 类通常与网络适配器 Cmdlet 结合使用。

示例

以下 PowerShell 示例可检索具有指定设备 ID 的本地 MSFT_NetAdapter。

$deviceID = "{11111111-2222-3333-4444-555555555555}"
Get-WmiObject -ComputerName "." -Namespace Root\StandardCimv2 -class MSFT_NetAdapter | Where-Object {$_.DeviceID -eq $deviceID}

要求


最低受支持的客户端	Windows 8
支持的最低服务器版本	Windows Server 2012
命名空间	Root\StandardCimv2
MOF	NetAdapterCim.mof
DLL	NetAdapterCim.dll

通过

MSFT_NetAdapter 类

语法

成员

方法

属性

注解

示例

要求

反馈

其他资源