Win32_NetworkAdapter 類別

發行項
11/10/2023

Win32_NetworkAdapter 類別已被取代。請改用 MSFT_NetAdapter 類別。 Win32_NetworkAdapter WMI 類別代表執行 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

數據類型：字串
存取類型：唯讀
限定符：MappingStrings （“DeviceIoControl：：OID_GEN_MEDIA_IN_USE”）

使用中的網路媒體。網路配接器如下所示：

乙太網路 802.3 （“乙太網络 802.3”）

Token Ring 802.5 （“Token Ring 802.5”）

光纖分散式數據介面（FDDI） （“Fiber Distributed Data Interface （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）

科萬（12）

1394 （13）

AutoSense

數據類型： 布爾值
存取類型：唯讀

如果 為 True，網路適配器可以自動判斷連結或網路媒體的速度。

此屬性繼承自 CIM_NetworkAdapter。

這個屬性尚未實作。它預設會 傳回NULL 值。

可用性

數據類型： uint16
存取類型：唯讀
限定符： MappingStrings （“MIF.DMTF|Operational State|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）

裝置很安靜。

標題

數據類型：字串
存取類型：唯讀
限定符： 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

數據類型：字串
存取類型：唯讀
限定符： CIM_Key

要出現在實例建立時所用繼承鏈結中之第一個具體類別的名稱。與類別的其他索引鍵屬性搭配使用時，屬性允許唯一識別此類別及其子類別的所有實例。

此屬性繼承自 CIM_LogicalDevice。

說明

數據類型：字串
存取類型：唯讀
限定符： DisplayName （“Description”）

物件的描述。

此屬性繼承自 CIM_ManagedSystemElement。

DeviceID

數據類型：字串
存取類型：唯讀
限定符：索引鍵、覆寫（“DeviceId”），MappingStrings （“Win32Registry|System\\CurrentControlSet\\Control\\Class\\{4D36E972-E325-11CE-BFC1-08002BE10318}“）

來自系統上其他裝置之網路適配器的唯一標識符。

此屬性繼承自 CIM_LogicalDevice。

ErrorCleared

數據類型： 布爾值
存取類型：唯讀

如果為 True，則會清除 LastErrorCode 中報告的錯誤。

此屬性繼承自 CIM_LogicalDevice。

ErrorDescription

數據類型：字串
存取類型：唯讀

有關 LastErrorCode 中記錄之錯誤的詳細資訊，以及可能採取之任何更正動作的相關信息。

此屬性繼承自 CIM_LogicalDevice。

GUID

數據類型：字串
存取類型：唯讀

線上的全域唯一標識碼。

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

數據類型：字串
存取類型：唯讀
限定符： MappingStrings （“Win32API|裝置輸入和輸出函式 |DeviceIoControl“）

此網路適配器的媒體訪問控制位址。 MAC 位址是製造商指派給網路適配器的唯一 48 位號碼。它會唯一識別此網路適配器，並用於對應 TCP/IP 網路通訊。

製造商

數據類型：字串
存取類型：唯讀
限定符： MappingStrings （“Win32Registry|Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards|製造商“）

網路適配器製造商的名稱。

範例：“3COM”

MaxNumberControlled

數據類型： uint32
存取類型：唯讀
限定符： MappingStrings （“MIF.DMTF|總線埠|001.9|附件數目上限“）

此網路適配器支援的直接可尋址埠數目上限。如果數位未知，則應該使用值為 0 （零）。

MaxSpeed

數據類型： uint64
存取類型：唯讀
限定符：單位（「每秒位數」）

網路適配器的最大速度，以每秒位數為單位。

此屬性繼承自 CIM_NetworkAdapter。

這個屬性尚未實作。它預設會 傳回NULL 值。

如需在腳本中使用 uint64 值的詳細資訊，請參閱 WMI 中的腳本。

名稱

數據類型：字串
存取類型：唯讀
限定符： DisplayName （“Name”）

標記，物件為已知。子類別化時，屬性可以覆寫為索引鍵屬性。

此屬性繼承自 CIM_ManagedSystemElement。

Net 連線 ionID

數據類型：字串
存取類型：讀取/寫入

網路連線的名稱，因為它出現在網路連線 控制台程式中。

Net 連線 ionStatus

數據類型： uint16
存取類型：唯讀

網路網路適配器連線的狀態。

已中斷 連線（0）

連線（1）

連線（2）

中斷連線 （3）

硬體不存在 （4）

硬體已 停用（5）

硬體故障 （6）

媒體中斷連線 （7）

驗證（8）

驗證成功 （9）

認證失敗 （10）

不合法的位址 （11）

必要認證（12）

其他

13–65535

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 類別上，而且可以實作。如需詳細資訊，請參閱設計 Managed 物件格式（MOF）類別。

支援電源迴圈（6）

您可以叫用 SetPowerState 方法，並將 PowerState 參數設定為 5 （Power Cycle）。

支援的 計時電源（7）

支援的計時電源

您可以叫用 SetPowerState 方法，並將 PowerState 參數設定為 5（Power Cycle），並將時間設定為特定日期和時間，或開啟電源的間隔。

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 中的腳本。

狀態

數據類型：字串
存取類型：唯讀
限定符： MaxLen （10）， DisplayName （“Status”）

物件的目前狀態。此屬性繼承自 CIM_ManagedSystemElement。

包括下列值：

確定（“OK”）

錯誤（「錯誤」

已降級 （「已降級」

未知（“未知”）

Pred Fail （“Pred Fail”）

啟動（“開始”）

停止（“停止”）

服務（“Service”）

壓力（“壓力”）

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.名稱CIM_Key

範圍系統的名稱。

此屬性繼承自 CIM_LogicalDevice。

TimeOfLastReset

數據類型： datetime
存取類型：唯讀
限定符： MappingStrings （“SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Perflib\\009|系統啟動時間「）

網路適配器上次重設的日期和時間。

備註

Win32_NetworkAdapter類別衍生自 CIM_NetworkAdapter。

下列清單描述Win32_NetworkAdapter的關聯器類別：

許多系統都有一些網路適配器。請考慮使用下列專案作為尋找目前配接器的參考：

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 函式（ TwoWmiFunctions.ps1 ） PowerShell 程式碼範例會使用 Win32_NetworkAdapter 重新建立 Windows Get-NetAdapter Cmdlet。

下列 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
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另請參閱

CIM_NetworkAdapter
電腦系統硬體類別
WMI 工作：網路
WMI 中的 IPv6 和 IPv4 支援

共用方式為

Win32_NetworkAdapter 類別

語法

成員

方法

屬性

備註

範例

需求

另請參閱

意見反應

其他資源