classe Win32_NetworkAdapter

La classe Win32_NetworkAdapter è deprecata. Usare invece la classe MSFT_NetAdapter. La classe WMI Win32_NetworkAdapterrappresenta una scheda di rete di un computer che esegue un sistema operativo Windows.

Win32_NetworkAdapter fornisce solo i dati IPv4. Per altre informazioni, vedere Supporto IPv6 e IPv4 in WMI.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà sono elencate in ordine alfabetico, non in ordine MOF.

Sintassi

[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;
};

Membri

La classe Win32_NetworkAdapter ha questi tipi di membri:

Metodi

La classe Win32_NetworkAdapter include questi metodi.

Metodo Descrizione
Disabilita Disabilita la scheda di rete.
Abilitazione Abilita la scheda di rete.
Reimposta Non implementata. Per altre informazioni su come implementare questo metodo, vedere il metodo Reset in CIM_NetworkAdapter.
SetPowerState Non implementata. Per altre informazioni su come implementare questo metodo, vedere il metodo SetPowerState in CIM_NetworkAdapter.

 

Proprietà

La classe Win32_NetworkAdapter ha queste proprietà.

AdapterType

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("DeviceIoControl::OID_GEN_MEDIA_IN_Uedizione Standard")

Supporto di rete in uso. Le schede di rete sono le seguenti:

Ethernet 802.3 ("Ethernet 802.3")

Token Ring 802.5 ("Token Ring 802.5")

Fiber Distributed Data Interface (FDDI) ("Fiber Distributed Data Interface (FDDI)")

Wide Area Network (WAN) ("Wide Area Network (WAN)")

LocalTalk ("LocalTalk")

Ethernet con formato di intestazione DIX ("Ethernet con formato di intestazione DIX")

ARCNET ("ARCNET")

ARCNET (878.2) ("ARCNET (878.2)")

BANCOMAT ("ATM")

Wireless ("Wireless ")

Wireless a infrarossi ("Wireless a infrarossi")

Bpc ("Bpc")

CoWan ("CoWan")

1394 ("1394")

AdapterTypeID

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("DeviceIoControl::OID_GEN_MEDIA_IN_Uedizione Standard")

Supporto di rete in uso. Restituisce le stesse informazioni della proprietà AdapterType , ad eccezione del fatto che le informazioni sono sotto forma di numero intero.

Ethernet 802.3 (0)

Anello token 802.5 (1)

Fiber Distributed Data Interface (FDDI) (2)

Wide Area Network (WAN) (3)

LocalTalk (4)

Ethernet con formato di intestazione DIX (5)

ARCNET (6)

ARCNET (878.2) (7)

BANCOMAT (8)

Wireless (9)

Wireless a infrarossi (10)

Bpc (11)

CoWan (12)

1394 (13)

AutoSense

Tipo di dati: booleano

Tipo di accesso: sola lettura

Se True, la scheda di rete può determinare automaticamente la velocità dei supporti collegati o di rete.

Questa proprietà viene ereditata da CIM_NetworkAdapter.

Questa proprietà non è ancora stata implementata. Restituisce un valore NULL per impostazione predefinita.

Disponibilità

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |Stato operativo|003.5", "MIB. IETF |HOST-RESOURCES-MIB.hrDeviceStatus")

Disponibilità e stato del dispositivo.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Altro (1)

Sconosciuto (2)

Esecuzione/alimentazione completa (3)

Esecuzione o alimentazione completa

Avviso (4)

In test (5)

Non applicabile (6)

Spegnimento (7)

Fuori linea (8)

Fuori servizio (9)

Degradato (10)

Non installato (11)

Errore di installazione (12)

Risparmio energia - Sconosciuto (13)

Il dispositivo è noto per essere in uno stato di risparmio energia, ma lo stato esatto è sconosciuto.

Risparmio energia - Modalità risparmio energia ridotta (14)

Il dispositivo è in uno stato di risparmio energia, ma ancora funzionante e può presentare prestazioni ridotte.

Risparmio energia - Standby (15)

Il dispositivo non funziona, ma può essere portato a piena potenza rapidamente.

Ciclo di alimentazione (16)

Risparmio energia - Avviso (17)

Il dispositivo è in uno stato di avviso, anche se in uno stato di risparmio energia.

Sospeso (18)

Il dispositivo è in pausa.

Non pronto (19)

Il dispositivo non è pronto.

Non configurato (20)

Il dispositivo non è configurato.

Quiesced (21)

Il dispositivo è silenzioso.

Caption

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64), DisplayName ("Caption")

Breve descrizione dell'oggetto, ovvero una stringa di una riga.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

ConfigManagerErrorCode

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: schema ("Win32")

Codice di errore di Windows Configuration Manager.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Questo dispositivo funziona correttamente. (0)

Il dispositivo funziona correttamente.

Questo dispositivo non è configurato correttamente. (1)

Il dispositivo non è configurato correttamente.

Windows non può caricare il driver per questo dispositivo. (2)

Il driver per questo dispositivo potrebbe essere danneggiato o il sistema potrebbe essere in esecuzione insufficiente nella memoria o in altre risorse. (3)

Il driver per questo dispositivo potrebbe essere danneggiato o il sistema potrebbe essere insufficiente nella memoria o in altre risorse.

Questo dispositivo non funziona correttamente. Uno dei driver o del Registro di sistema potrebbe essere danneggiato. (4)

Il dispositivo non funziona correttamente. Uno dei driver o del Registro di sistema potrebbe essere danneggiato.

Il driver per questo dispositivo richiede una risorsa che Windows non può gestire. (5)

Il driver per il dispositivo richiede una risorsa che Windows non può gestire.

La configurazione di avvio per questo dispositivo è in conflitto con altri dispositivi. (6)

La configurazione di avvio per il dispositivo è in conflitto con altri dispositivi.

Impossibile filtrare. (7)

Il caricatore driver per il dispositivo non è presente. (8)

Driver loader per il dispositivo mancante.

Questo dispositivo non funziona correttamente perché il firmware di controllo segnala erroneamente le risorse per il dispositivo. (9)

Il dispositivo non funziona correttamente. Il firmware di controllo segnala erroneamente le risorse per il dispositivo.

Impossibile avviare il dispositivo. (10)

Impossibile avviare il dispositivo.

Il dispositivo non è riuscito. (11)

Dispositivo non riuscito.

Questo dispositivo non riesce a trovare risorse gratuite sufficienti che può usare. (12)

Il dispositivo non riesce a trovare risorse sufficienti da usare.

Windows non è in grado di verificare le risorse del dispositivo. (13)

Windows non è in grado di verificare le risorse del dispositivo.

Questo dispositivo non può funzionare correttamente fino a quando non si riavvia il computer. (14)

Il dispositivo non può funzionare correttamente finché il computer non viene riavviato.

Questo dispositivo non funziona correttamente perché è probabile che si verifichi un problema di rienumerazione. (15)

Il dispositivo non funziona correttamente a causa di un possibile problema di rienumerazione.

Windows non è in grado di identificare tutte le risorse usate dal dispositivo. (16)

Windows non è in grado di identificare tutte le risorse usate dal dispositivo.

Questo dispositivo richiede un tipo di risorsa sconosciuto. (17)

Il dispositivo richiede un tipo di risorsa sconosciuto.

Reinstallare i driver per questo dispositivo. (18)

I driver di dispositivo devono essere reinstallati.

Errore durante l'uso del caricatore VxD. (19)

Il registro potrebbe essere danneggiato. (20)

Il Registro di sistema potrebbe essere danneggiato.

Errore di sistema: provare a modificare il driver per questo dispositivo. Se non funziona, vedere la documentazione hardware. Windows rimuove questo dispositivo. (21)

Errore di sistema. Se la modifica del driver di dispositivo è inefficace, vedere la documentazione hardware. Windows rimuove il dispositivo.

Questo dispositivo è disabilitato. (22)

Il dispositivo è disabilitato.

Errore di sistema: provare a modificare il driver per questo dispositivo. In caso contrario, vedere la documentazione dell'hardware. (23)

Errore di sistema. Se la modifica del driver di dispositivo è inefficace, vedere la documentazione hardware.

Questo dispositivo non è presente, non funziona correttamente o non dispone di tutti i driver installati. (24)

Il dispositivo non è presente, non funziona correttamente o non dispone di tutti i driver installati.

Windows sta ancora configurando questo dispositivo. (25)

Windows sta ancora configurando il dispositivo.

Windows sta ancora configurando questo dispositivo. (26)

Windows sta ancora configurando il dispositivo.

Questo dispositivo non dispone di una configurazione log valida. (27)

Il dispositivo non dispone di una configurazione log valida.

I driver per questo dispositivo non sono installati. (28)

I driver di dispositivo non sono installati.

Questo dispositivo è disabilitato perché il firmware del dispositivo non ha dato le risorse necessarie. (29)

Il dispositivo è disabilitato. Il firmware del dispositivo non ha fornito le risorse necessarie.

Questo dispositivo usa una risorsa IRQ (Interrupt Request) usata da un altro dispositivo. (30)

Il dispositivo usa una risorsa IRQ usata da un altro dispositivo.

Questo dispositivo non funziona correttamente perché Windows non è in grado di caricare i driver necessari per questo dispositivo. (31)

Il dispositivo non funziona correttamente. Windows non può caricare i driver di dispositivo necessari.

ConfigManagerUserConfig

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: schema ("Win32")

Se True, il dispositivo usa una configurazione definita dall'utente.

Questa proprietà viene ereditata da CIM_LogicalDevice.

CreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: CIM_Key

Nome della prima classe concreta da visualizzare nella catena di ereditarietà utilizzata nella creazione di un'istanza. Se utilizzata con le altre proprietà chiave della classe, la proprietà consente l'identificazione univoca di tutte le istanze di questa classe e delle relative sottoclassi.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Description")

Descrizione dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Deviceid

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: Key, Override ("DeviceId"), MappingStrings ("Win32Registry|System\\CurrentControlSet\\Control\\Class\\{4D36E972-E325-11CE-BFC1-08002BE10318}")

Identificatore univoco della scheda di rete di altri dispositivi nel sistema.

Questa proprietà viene ereditata da CIM_LogicalDevice.

ErrorCleared

Tipo di dati: booleano

Tipo di accesso: sola lettura

Se True, l'errore segnalato in LastErrorCode viene ora cancellato.

Questa proprietà viene ereditata da CIM_LogicalDevice.

ErrorDescription

Tipo di dati: string

Tipo di accesso: sola lettura

Altre informazioni sull'errore registrato in LastErrorCode e informazioni sulle azioni correttive che possono essere eseguite.

Questa proprietà viene ereditata da CIM_LogicalDevice.

GUID

Tipo di dati: string

Tipo di accesso: sola lettura

Identificatore univoco globale per la connessione.

Indice

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32Registry|System\\CurrentControlSet\\Control\\Class\\{4D36E972-E325-11CE-BFC1-08002BE10318}")

Numero di indice della scheda di rete archiviata nel Registro di sistema.

Esempio: 0

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |ComponentID|001.5"), DisplayName ("Data di installazione")

Data e ora di installazione dell'oggetto. Questa proprietà non richiede un valore per indicare che l'oggetto è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Questa proprietà non è ancora stata implementata. Restituisce un valore NULL per impostazione predefinita.

Installato

Tipo di dati: booleano

Tipo di accesso: sola lettura

Qualificatori: DEPRECATO, MappingStrings ("Win32Registry|Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards|DriverDate")

Se True, la scheda di rete viene installata nel sistema.

InterfaceIndex

Tipo di dati: uint32

Tipo di accesso: sola lettura

Valore di indice che identifica in modo univoco l'interfaccia di rete locale. Il valore di questa proprietà corrisponde al valore della proprietà InterfaceIndex nell'istanza di Win32_IP4RouteTable che rappresenta l'interfaccia di rete nella tabella di route.

LastErrorCode

Tipo di dati: uint32

Tipo di accesso: sola lettura

Ultimo codice di errore segnalato dal dispositivo logico.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Macaddress

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32API|Funzioni di input e output del dispositivo |DeviceIoControl")

Indirizzo di controllo di accesso multimediale per questa scheda di rete. Un indirizzo MAC è un numero univoco a 48 bit assegnato alla scheda di rete dal produttore. Identifica in modo univoco questa scheda di rete e viene usata per il mapping delle comunicazioni di rete TCP/IP.

Produttore

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards|Produttore")

Nome del produttore della scheda di rete.

Esempio: "3COM"

MaxNumberControllato

Tipo di dati: uint32

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |Porta bus|001.9|Numero massimo di allegati")

Numero massimo di porte indirizzabili direttamente supportate da questa scheda di rete. Se il numero è sconosciuto, è necessario usare il valore 0 (zero).

Maxspeed

Tipo di dati: uint64

Tipo di accesso: sola lettura

Qualificatori: unità ("bit al secondo")

Velocità massima, in bit al secondo, per la scheda di rete.

Questa proprietà viene ereditata da CIM_NetworkAdapter.

Questa proprietà non è ancora stata implementata. Restituisce un valore NULL per impostazione predefinita.

Per altre informazioni sull'uso di valori uint64 negli script, vedere Scripting in WMI.

Nome

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: DisplayName ("Name")

Etichetta in base alla quale l'oggetto è noto. Se sottoclassata, è possibile eseguire l'override della proprietà in modo che sia una proprietà chiave.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Net Connessione ionID

Tipo di dati: string

Tipo di accesso: lettura/scrittura

Nome della connessione di rete visualizzata nel programma Pannello di controllo network Connessione ions.

Net Connessione ionStatus

Tipo di dati: uint16

Tipo di accesso: sola lettura

Stato della connessione della scheda di rete alla rete.

Disconnesso (0)

Connessione ing (1)

Connessione (2)

Disconnessione (3)

Hardware non presente (4)

Hardware disabilitato (5)

Malfunzionamento hardware (6)

Supporti disconnessi (7)

Autenticazione (8)

Autenticazione riuscita (9)

Autenticazione non riuscita (10)

Indirizzo non valido (11)

Credenziali necessarie (12)

Altri

13–65535

NetEnabled

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se l'adattatore è abilitato o meno. Se True, l'adattatore è abilitato. È possibile abilitare o disabilitare la scheda di interfaccia di rete usando i metodi Enable e Disable.

NetworkAddresses

Tipo di dati: matrice di stringhe

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64), MappingStrings ("MIF. DMTF |Porta 802 scheda di rete|001.3")

Matrice di indirizzi di rete per una scheda.

Questa proprietà viene ereditata da CIM_NetworkAdapter.

Questa proprietà non è ancora stata implementata. Restituisce un valore NULL per impostazione predefinita.

PermanentAddress

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64), MappingStrings ("MIF. DMTF |Porta 802 della scheda di rete|001.2")

Indirizzo di rete hardcoded in una scheda. Questo indirizzo hardcoded può essere modificato dall'aggiornamento del firmware o dalla configurazione software. In tal caso, questo campo deve essere aggiornato quando viene apportata la modifica. La proprietà deve essere lasciata vuota se non esiste alcun indirizzo hardcoded per la scheda di rete.

Questa proprietà viene ereditata da CIM_NetworkAdapter.

Questa proprietà non è ancora stata implementata. Restituisce un valore NULL per impostazione predefinita.

PhysicalAdapter

Tipo di dati: booleano

Tipo di accesso: sola lettura

Indica se l'adattatore è un adattatore fisico o logico. Se True, l'adattatore è fisico.

PNPDeviceID

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: schema ("Win32")

Identificatore del dispositivo Plug and Play di Windows del dispositivo logico.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Esempio: "*PNP030b"

PowerManagementCapabilities

Tipo di dati: matrice uint16

Tipo di accesso: sola lettura

Matrice delle funzionalità specifiche correlate all'alimentazione di un dispositivo logico.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Sconosciuto (0)

Non supportato (1)

Disabilitato (2)

Abilitato (3)

Le funzionalità di risparmio energia sono attualmente abilitate, ma il set di funzionalità esatto è sconosciuto o le informazioni non sono disponibili.

Modalità risparmio energia immesse automaticamente (4)

Il dispositivo può modificare lo stato di alimentazione in base all'utilizzo o ad altri criteri.

Power State Settable (5)

Il metodo SetPowerState è supportato. Questo metodo è disponibile nella classe padre CIM_LogicalDevice e può essere implementato. Per altre informazioni, vedere Progettazione di classi MOF (Managed Object Format).

Power Cycling supportato (6)

Il metodo SetPowerState può essere richiamato con il parametro PowerState impostato su 5 (Power Cycle).

Accensione temporizzato supportata (7)

Accensione temporizzato supportata

Il metodo SetPowerState può essere richiamato con il parametro PowerState impostato su 5 (Power Cycle) e Time impostato su una data e un'ora specifiche, o intervallo, per l'accensione.

PowerManagementSupported

Tipo di dati: booleano

Tipo di accesso: sola lettura

Se True, il dispositivo può essere gestito dall'alimentazione (può essere messo in modalità di sospensione e così via). La proprietà non indica che le funzionalità di risparmio energia sono attualmente abilitate, ma solo che il dispositivo logico è in grado di gestire il risparmio energia.

Questa proprietà viene ereditata da CIM_LogicalDevice.

ProductName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards|ServiceName")

Nome prodotto della scheda di rete.

Esempio: "Fast EtherLink XL"

Servicename

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("Win32Registry|Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards|ProductName")

Nome del servizio della scheda di rete. Questo nome è in genere più breve del nome completo del prodotto.

Esempio: "Elnkii"

Velocità

Tipo di dati: uint64

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIB. IETF |RFC1213-MIB.ifSpeed", "MIF. DMTF |Scheda di rete 802 Porta|001.5"), Unità ("bit al secondo")

Stima della larghezza di banda corrente in bit al secondo. Per gli endpoint che variano in termini di larghezza di banda o per quelli in cui non è possibile eseguire stime accurate, questa proprietà deve contenere la larghezza di banda nominale.

Questa proprietà viene ereditata da CIM_NetworkAdapter.

Per altre informazioni sull'uso di valori uint64 negli script, vedere Scripting in WMI.

Stato

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (10), DisplayName ("Status")

Stato corrente dell'oggetto. Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Sono inclusi i valori seguenti:

OK ("OK ")

Errore ("Errore ")

Degradato ("degradato")

Sconosciuto ("Sconosciuto")

Pred Fail ("Pred Fail ")

Avvio ("Starting ")

Arresto ("arresto ")

Servizio ("Servizio")

Sottolineato ("sottolineato ")

NonRecover ("NonRecover ")

Nessun contatto ("Nessun contatto ")

Lost Comm ("Lost Comm ")

StatusInfo

Tipo di dati: uint16

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("MIF. DMTF |Stato operativo|003.3")

Stato del dispositivo logico. Se questa proprietà non si applica al dispositivo logico, è necessario usare il valore 5 (Non applicabile).

Questa proprietà viene ereditata da CIM_LogicalDevice.

Altro (1)

Sconosciuto (2)

Abilitato (3)

Disabilitato (4)

Non applicabile (5)

SystemCreationClassName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: propagati ("CIM_System.CreationClassName"), CIM_Key

Valore della proprietà CreationClassName del computer di ambito.

Questa proprietà viene ereditata da CIM_LogicalDevice.

Systemname

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: propagati ("CIM_System.Nome"), CIM_Key

Nome del sistema di definizione dell'ambito.

Questa proprietà viene ereditata da CIM_LogicalDevice.

TimeOfLastReset

Tipo di dati: datetime

Tipo di accesso: sola lettura

Qualificatori: MappingStrings ("SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Perflib\\009|Tempo di attività di sistema")

Data e ora dell'ultima reimpostazione della scheda di rete.

Osservazioni:

La classe Win32_NetworkAdapter deriva da CIM_NetworkAdapter.

L'elenco seguente descrive le classi associator per Win32_NetworkAdapter:

Molti sistemi dispongono di una serie di schede di rete. Prendere in considerazione l'uso di quanto segue come riferimento per trovare gli adattatori correnti:

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>

Anche usando i qualificatori precedenti, è probabile che si recuperi più di una scheda di rete valida. In tal caso, è possibile usare le informazioni seguenti per qualificare ulteriormente la ricerca del 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

Al termine, è probabile che l'elenco sia stato ridotto a uno o due adattatori configurati.

È anche possibile utilizzare la procedura seguente per trovare l'adattatore predefinito:

  1. Eseguire la query riportata di seguito:

    "SELECT InterfaceIndex, Destination FROM Win32_IP4RouteTable WHERE Destination='0.0.0.0'"

    Dovrebbe essere disponibile una sola destinazione di rete predefinita 0.0.0.0.

  2. Usare InterfaceIndex per recuperare la scheda di rete desiderata.

    "SELECT * FROM Win32_NetworkAdapter WHERE InterfaceIndex=" + insertVariableHere

Esempi

L'esempio di codice di PowerShell Two WMI Functions (TwoWmiFunctions.ps1) in TechNet Gallery usa Win32_NetworkAdapter per ricreare il cmdlet Get-NetAdapter di Windows.

Nell'esempio di codice C# seguente viene usato lo spazio dei nomi Microsoft.Management.Infrastructure per recuperare le schede di rete correnti nel computer locale.

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();
        }

L'esempio di codice C# seguente usa https://msdn.microsoft.com/library/system.management.aspx lo spazio dei nomi per recuperare le schede di rete correnti nel computer locale.

Nota

https://msdn.microsoft.com/library/system.management.aspx contiene le classi originali usate per accedere a WMI; tuttavia, sono considerati più lenti e in genere non si ridimensionano e le controparti 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();

        }

Nell'esempio di codice VBScript seguente viene descritto come recuperare le schede di rete correnti nel computer locale.

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

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista
Server minimo supportato
Windows Server 2008
Spazio dei nomi
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Vedi anche

CIM_NetworkAdapter

Classi hardware del sistema informatico

Attività WMI: Rete

Supporto IPv6 e IPv4 in WMI