Compartir a través de


Win32_NetworkAdapter clase

La clase Win32_NetworkAdapter está en desuso. En su lugar, use la clase MSFT_NetAdapter . La Win32_NetworkAdapterclase WMI representa un adaptador de red de un equipo que ejecuta un sistema operativo Windows.

Win32_NetworkAdapter solo proporciona datos IPv4. Para obtener más información, consulte Compatibilidad con IPv6 e IPv4 en WMI.

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades se enumeran en orden alfabético, no en orden MOF.

Sintaxis

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

Miembros

La clase Win32_NetworkAdapter tiene estos tipos de miembros:

Métodos

La clase Win32_NetworkAdapter tiene estos métodos.

Método Descripción
Desactivar Deshabilita el adaptador de red.
Habilitar Habilita el adaptador de red.
Reset Sin implementar. Para obtener más información sobre cómo implementar este método, vea el método Reset en CIM_NetworkAdapter.
SetPowerState Sin implementar. Para obtener más información sobre cómo implementar este método, vea el método SetPowerState en CIM_NetworkAdapter.

 

Propiedades

La clase Win32_NetworkAdapter tiene estas propiedades.

AdapterType

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("DeviceIoControl::OID_GEN_MEDIA_IN_USE")

Medio de red en uso. Los adaptadores de red son los siguientes:

Ethernet 802.3 ("Ethernet 802.3")

Token Ring 802.5 ("Token Ring 802.5")

Interfaz de datos distribuidos de fibra (FDDI) ("Interfaz de datos distribuidos de fibra (FDDI)")

Red de área extensa (WAN) ("Red de área extensa (WAN)")

LocalTalk ("LocalTalk")

Ethernet con formato de encabezado DIX ("Ethernet con formato de encabezado DIX")

ARCNET ("ARCNET")

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

ATM ("ATM")

Inalámbrico ("Inalámbrico")

Infrarrojo Inalámbrico ("Infrarrojo Inalámbrico")

Bpc ("Bpc")

CoWan ("CoWan")

1394 ("1394")

AdapterTypeID

Tipo de datos: uint16

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("DeviceIoControl::OID_GEN_MEDIA_IN_USE")

Medio de red en uso. Devuelve la misma información que la propiedad AdapterType , salvo que la información está en forma de entero.

Ethernet 802.3 (0)

Token Ring 802.5 (1)

Interfaz de datos distribuidos de fibra (FDDI) ( 2)

Red de área extensa (WAN) ( 3)

LocalTalk (4)

Ethernet con formato de encabezado DIX (5)

ARCNET (6)

ARCNET (878.2) (7)

ATM (8)

Inalámbrico (9)

Infrarrojo inalámbrico (10)

Bpc (11)

CoWan (12)

1394 (13)

AutoSense

Tipo de datos: booleano

Tipo de acceso: solo lectura

Si es True, el adaptador de red puede determinar automáticamente la velocidad de los medios conectados o de red.

Esta propiedad se hereda de CIM_NetworkAdapter.

Esta propiedad aún no se ha implementado. Devuelve un valor NULL de forma predeterminada.

Disponibilidad

Tipo de datos: uint16

Tipo de acceso: solo lectura

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

Disponibilidad y estado del dispositivo.

Esta propiedad se hereda de CIM_LogicalDevice.

Otros (1)

Desconocido (2)

Corriente/potencia completa (3)

Ejecución o energía completa

Advertencia (4)

En prueba (5)

No aplicable (6)

Apagar (7)

Off Line (8)

Off Duty (9)

Degradado (10)

No instalado (11)

Error de instalación (12)

Ahorro de energía- Desconocido (13)

Se sabe que el dispositivo está en un estado de ahorro de energía, pero su estado exacto es desconocido.

Ahorro de energía- Modo de bajo consumo (14)

El dispositivo está en un estado de ahorro de energía, pero sigue funcionando y puede mostrar un rendimiento degradado.

Ahorro de energía : en espera (15)

El dispositivo no funciona, pero se podría traer rápidamente a toda la potencia.

Ciclo de alimentación (16)

Ahorro de energía: advertencia (17)

El dispositivo está en un estado de advertencia, aunque también en un estado de ahorro de energía.

En pausa (18)

El dispositivo está en pausa.

No listo (19)

El dispositivo no está listo.

No configurado (20)

El dispositivo no está configurado.

En modo en modo incoado (21)

El dispositivo es silencioso.

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

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

Descripción breve del objeto: una cadena de una línea.

Esta propiedad se hereda de CIM_ManagedSystemElement.

ConfigManagerErrorCode

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: Esquema ("Win32")

Código de error de Windows Configuration Manager.

Esta propiedad se hereda de CIM_LogicalDevice.

Este dispositivo funciona correctamente. (0)

El dispositivo funciona correctamente.

Este dispositivo no está configurado correctamente. (1)

El dispositivo no está configurado correctamente.

Windows no puede cargar el controlador para este dispositivo. (2)

Es posible que el controlador de este dispositivo esté dañado o que el sistema se esté ejecutando poco en memoria u otros recursos. (3)

Es posible que el controlador de este dispositivo esté dañado o que el sistema tenga poca memoria u otros recursos.

Este dispositivo no funciona correctamente. Uno de sus controladores o el registro podrían estar dañados. (4)

El dispositivo no funciona correctamente. Uno de sus controladores o el registro podrían estar dañados.

El controlador de este dispositivo necesita un recurso que Windows no puede administrar. (5)

El controlador para el dispositivo requiere un recurso que Windows no puede administrar.

La configuración de arranque de este dispositivo entra en conflicto con otros dispositivos. (6)

La configuración de arranque del dispositivo entra en conflicto con otros dispositivos.

No se puede filtrar. (7)

Falta el cargador de controladores para el dispositivo. (8)

Falta el cargador de controladores para el dispositivo.

Este dispositivo no funciona correctamente porque el firmware de control notifica los recursos del dispositivo incorrectamente. (9)

El dispositivo no funciona correctamente. El firmware de control informa incorrectamente de los recursos del dispositivo.

Este dispositivo no se puede iniciar. (10)

El dispositivo no se puede iniciar.

Error en este dispositivo. (11)

Error en el dispositivo.

Este dispositivo no encuentra suficientes recursos libres que puede usar. (12)

El dispositivo no encuentra suficientes recursos gratuitos para usar.

Windows no puede comprobar los recursos de este dispositivo. (13)

Windows no puede comprobar los recursos del dispositivo.

Este dispositivo no puede funcionar correctamente hasta que reinicie el equipo. (14)

El dispositivo no puede funcionar correctamente hasta que se reinicie el equipo.

Este dispositivo no funciona correctamente porque probablemente haya un problema de volver a enumerar. (15)

El dispositivo no funciona correctamente debido a un posible problema de volver a enumerar.

Windows no puede identificar todos los recursos que usa este dispositivo. (16)

Windows no puede identificar todos los recursos que usa el dispositivo.

Este dispositivo solicita un tipo de recurso desconocido. (17)

El dispositivo solicita un tipo de recurso desconocido.

Vuelva a instalar los controladores para este dispositivo. (18)

Los controladores de dispositivo deben volver a instalarse.

Error al usar el cargador VxD. (19)

Es posible que el registro esté dañado. (20)

Es posible que el Registro esté dañado.

Error del sistema: intente cambiar el controlador de este dispositivo. Si eso no funciona, consulte la documentación de hardware. Windows está quitando este dispositivo. (21)

Error del sistema. Si cambiar el controlador de dispositivo es ineficaz, consulte la documentación de hardware. Windows está quitando el dispositivo.

Este dispositivo está deshabilitado. (22)

El dispositivo está deshabilitado.

Error del sistema: intente cambiar el controlador de este dispositivo. Si eso no funciona, consulte la documentación de hardware. (23)

Error del sistema. Si cambiar el controlador de dispositivo es ineficaz, consulte la documentación de hardware.

Este dispositivo no está presente, no funciona correctamente o no tiene instalados todos sus controladores. (24)

El dispositivo no está presente, no funciona correctamente o no tiene todos sus controladores instalados.

Windows sigue configurando este dispositivo. (25)

Windows sigue configurando el dispositivo.

Windows sigue configurando este dispositivo. (26)

Windows sigue configurando el dispositivo.

Este dispositivo no tiene una configuración de registro válida. (27)

El dispositivo no tiene una configuración de registro válida.

Los controladores de este dispositivo no están instalados. (28)

Los controladores de dispositivo no están instalados.

Este dispositivo está deshabilitado porque el firmware del dispositivo no le dio los recursos necesarios. (29)

El dispositivo está deshabilitado. El firmware del dispositivo no proporcionó los recursos necesarios.

Este dispositivo usa un recurso de solicitud de interrupción (IRQ) que usa otro dispositivo. (30)

El dispositivo usa un recurso IRQ que usa otro dispositivo.

Este dispositivo no funciona correctamente porque Windows no puede cargar los controladores necesarios para este dispositivo. (31)

El dispositivo no funciona correctamente. Windows no puede cargar los controladores de dispositivo necesarios.

ConfigManagerUserConfig

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: Esquema ("Win32")

Si es True, el dispositivo usa una configuración definida por el usuario.

Esta propiedad se hereda de CIM_LogicalDevice.

CreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: CIM_Key

Nombre de la primera clase concreta que aparece en la cadena de herencia utilizada en la creación de una instancia. Cuando se usa con las otras propiedades clave de la clase , la propiedad permite identificar de forma única todas las instancias de esta clase y sus subclases.

Esta propiedad se hereda de CIM_LogicalDevice.

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Descripción")

Descripción del objeto .

Esta propiedad se hereda de CIM_ManagedSystemElement.

Deviceid

Tipo de datos: cadena

Tipo de acceso: solo lectura

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

Identificador único del adaptador de red de otros dispositivos del sistema.

Esta propiedad se hereda de CIM_LogicalDevice.

ErrorCleared

Tipo de datos: booleano

Tipo de acceso: solo lectura

Si es True, el error notificado en LastErrorCode ahora se borra.

Esta propiedad se hereda de CIM_LogicalDevice.

ErrorDescription

Tipo de datos: cadena

Tipo de acceso: solo lectura

Más información sobre el error registrado en LastErrorCode e información sobre las acciones correctivas que se pueden realizar.

Esta propiedad se hereda de CIM_LogicalDevice.

GUID

Tipo de datos: cadena

Tipo de acceso: solo lectura

Identificador único global de la conexión.

Index

Tipo de datos: uint32

Tipo de acceso: solo lectura

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

Número de índice del adaptador de red, almacenado en el registro del sistema.

Ejemplo: 0

InstallDate

Tipo de datos: datetime

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")

Fecha y hora en que se instaló el objeto. Esta propiedad no necesita un valor para indicar que el objeto está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Esta propiedad aún no se ha implementado. Devuelve un valor NULL de forma predeterminada.

Instalado

Tipo de datos: booleano

Tipo de acceso: solo lectura

Calificadores: EN DESUSO, MappingStrings ("Win32Registry| Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards| DriverDate")

Si es True, el adaptador de red se instala en el sistema.

InterfaceIndex

Tipo de datos: uint32

Tipo de acceso: solo lectura

Valor de índice que identifica de forma única la interfaz de red local. El valor de esta propiedad es el mismo que el valor de la propiedad InterfaceIndex en la instancia de Win32_IP4RouteTable que representa la interfaz de red de la tabla de rutas.

LastErrorCode

Tipo de datos: uint32

Tipo de acceso: solo lectura

Último código de error notificado por el dispositivo lógico.

Esta propiedad se hereda de CIM_LogicalDevice.

MACAddress

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32API| Funciones de entrada y salida del dispositivo | DeviceIoControl")

Dirección de control de acceso multimedia para este adaptador de red. Una dirección MAC es un número único de 48 bits asignado al adaptador de red por el fabricante. Identifica de forma única este adaptador de red y se usa para asignar comunicaciones de red TCP/IP.

Fabricante

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("Win32Registry| Software\\Microsoft\\Windows NT\\CurrentVersion\\NetworkCards| Fabricante")

Nombre del fabricante del adaptador de red.

Ejemplo: "3COM"

MaxNumberControl

Tipo de datos: uint32

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| Puerto de autobús|001.9| Número máximo de datos adjuntos")

Número máximo de puertos direccionables directamente compatibles con este adaptador de red. Se debe usar un valor de 0 (cero) si se desconoce el número.

MaxSpeed

Tipo de datos: uint64

Tipo de acceso: solo lectura

Calificadores: unidades ("bits por segundo")

Velocidad máxima, en bits por segundo, para el adaptador de red.

Esta propiedad se hereda de CIM_NetworkAdapter.

Esta propiedad aún no se ha implementado. Devuelve un valor NULL de forma predeterminada.

Para más información sobre el uso de valores uint64 en scripts, vea Scripting in WMI.

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: DisplayName ("Name")

Etiqueta por la que se conoce el objeto. Cuando se subclase, la propiedad se puede invalidar para que sea una propiedad de clave.

Esta propiedad se hereda de CIM_ManagedSystemElement.

NetConnectionID

Tipo de datos: cadena

Tipo de acceso: lectura/escritura

Nombre de la conexión de red tal como aparece en el programa Conexiones de red Panel de control.

NetConnectionStatus

Tipo de datos: uint16

Tipo de acceso: solo lectura

Estado de la conexión del adaptador de red a la red.

Desconectado (0)

Conexión (1)

Conectado (2)

Desconexión (3)

Hardware no presente (4)

Hardware deshabilitado (5)

Funcionamiento incorrecto del hardware (6)

Medios desconectados (7)

Autenticación (8)

Autenticación correcta (9)

Error de autenticación (10)

Dirección no válida (11)

Credenciales necesarias (12)

Otros

13–65535

NetEnabled

Tipo de datos: booleano

Tipo de acceso: solo lectura

Indica si el adaptador está habilitado o no. Si es True, el adaptador está habilitado. Puede habilitar o deshabilitar la NIC mediante los métodos Enable y Disable .

NetworkAddresses

Tipo de datos: matriz de cadenas

Tipo de acceso: solo lectura

Calificadores: MaxLen (64), MappingStrings ("MIF). DMTF| Adaptador de red 802 Puerto|001.3")

Matriz de direcciones de red para un adaptador.

Esta propiedad se hereda de CIM_NetworkAdapter.

Esta propiedad aún no se ha implementado. Devuelve un valor NULL de forma predeterminada.

PermanenteAddress

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (64), MappingStrings ("MIF). DMTF| Adaptador de red 802 Puerto|001.2")

Dirección de red codificada de forma rígida en un adaptador. Esta dirección codificada de forma rígida puede cambiarse mediante la actualización de firmware o la configuración de software. Si es así, este campo debe actualizarse cuando se realiza el cambio. La propiedad debe dejarse en blanco si no existe ninguna dirección codificada de forma rígida para el adaptador de red.

Esta propiedad se hereda de CIM_NetworkAdapter.

Esta propiedad aún no se ha implementado. Devuelve un valor NULL de forma predeterminada.

PhysicalAdapter

Tipo de datos: booleano

Tipo de acceso: solo lectura

Indica si el adaptador es físico o lógico. Si es True, el adaptador es físico.

PNPDeviceID

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: Esquema ("Win32")

Windows Plug and Play identificador de dispositivo del dispositivo lógico.

Esta propiedad se hereda de CIM_LogicalDevice.

Ejemplo: "*PNP030b"

PowerManagementCapabilities

Tipo de datos: matriz uint16

Tipo de acceso: solo lectura

Matriz de las funcionalidades específicas relacionadas con la energía de un dispositivo lógico.

Esta propiedad se hereda de CIM_LogicalDevice.

Desconocido (0)

No compatible (1)

Deshabilitado (2)

Habilitado (3)

Las características de administración de energía están habilitadas actualmente, pero el conjunto de características exacto es desconocido o la información no está disponible.

Modos de ahorro de energía introducidos automáticamente (4)

El dispositivo puede cambiar su estado de alimentación en función del uso u otros criterios.

Power State Settable (5)

Se admite el método SetPowerState . Este método se encuentra en la clase primaria CIM_LogicalDevice y se puede implementar. Para más información, vea Diseño de clases de formato de Managed Object Format (MOF).

Power Cycle Supported (6)

El método SetPowerState se puede invocar con el parámetro PowerState establecido en 5 (Ciclo de energía).

Encendido con tiempo admitido (7)

Se admiten Power-On con tiempo

El método SetPowerState se puede invocar con el parámetro PowerState establecido en 5 (ciclo de energía) y tiempo establecido en una fecha y hora específicas, o intervalo, para el encendido.

PowerManagementSupported

Tipo de datos: booleano

Tipo de acceso: solo lectura

Si es True, el dispositivo se puede administrar con energía (se puede poner en modo de suspensión, etc.). La propiedad no indica que las características de administración de energía están habilitadas actualmente, solo que el dispositivo lógico es capaz de administrar energía.

Esta propiedad se hereda de CIM_LogicalDevice.

ProductName

Tipo de datos: cadena

Tipo de acceso: solo lectura

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

Nombre del producto del adaptador de red.

Ejemplo: "Fast EtherLink XL"

ServiceName

Tipo de datos: cadena

Tipo de acceso: solo lectura

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

Nombre del servicio del adaptador de red. Este nombre suele ser más corto que el nombre completo del producto.

Ejemplo: "Elnkii"

Velocidad

Tipo de datos: uint64

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIB. IETF| RFC1213-MIB.ifSpeed", "MIF. DMTF| Adaptador de red 802 Puerto|001,5"), unidades ("bits por segundo")

Estimación del ancho de banda actual en bits por segundo. Para los puntos de conexión que varían en ancho de banda o para aquellos en los que no se puede realizar una estimación precisa, esta propiedad debe contener el ancho de banda nominal.

Esta propiedad se hereda de CIM_NetworkAdapter.

Para más información sobre el uso de valores uint64 en scripts, vea Scripting in WMI.

Estado

Tipo de datos: cadena

Tipo de acceso: solo lectura

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

Estado actual del objeto. Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores son los siguientes:

Ok ("OK")

Error ("Error")

Degradado ("Degradado")

Desconocido ("Desconocido")

Pred Fail ("Pred Fail ")

Inicio ("Inicio")

Detención ("Detención ")

Servicio ("Servicio")

Estresado ("Estresado")

NonRecover ("NonRecover")

Sin contacto ("Sin contacto")

Lost Comm ("Lost Comm")

StatusInfo

Tipo de datos: uint16

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("MIF. DMTF| Estado operativo|003.3")

Estado del dispositivo lógico. Si esta propiedad no se aplica al dispositivo lógico, se debe usar el valor 5 (no aplicable).

Esta propiedad se hereda de CIM_LogicalDevice.

Otros (1)

Desconocido (2)

Habilitado (3)

Deshabilitado (4)

No aplicable (5)

SystemCreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: propagados ("CIM_System. CreationClassName"), CIM_Key

Valor de la propiedad CreationClassName del equipo de ámbito.

Esta propiedad se hereda de CIM_LogicalDevice.

SystemName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: propagados ("CIM_System. Nombre"), CIM_Key

Nombre del sistema de ámbito.

Esta propiedad se hereda de CIM_LogicalDevice.

TimeOfLastReset

Tipo de datos: datetime

Tipo de acceso: solo lectura

Calificadores: MappingStrings ("SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Perflib\\009| Tiempo de puesta en marcha del sistema")

Fecha y hora en que se restableció por última vez el adaptador de red.

Comentarios

La clase Win32_NetworkAdapter se deriva de CIM_NetworkAdapter.

En la lista siguiente se describen las clases asociadores para Win32_NetworkAdapter:

Muchos sistemas tienen una serie de adaptadores de red en ellos. Considere la posibilidad de usar lo siguiente como referencia para buscar los adaptadores actuales:

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>

Incluso con los calificadores anteriores, es probable que recupere más de un adaptador de red válido. Si ese es el caso, puede usar la siguiente información para calificar aún más la búsqueda de la 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

Una vez hecho esto, es probable que haya reducido la lista a uno o dos adaptadores configurados.

También puede usar el procedimiento siguiente para buscar el adaptador predeterminado:

  1. Ejecute la siguiente consulta:

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

    Solo debe tener un destino de red predeterminado 0.0.0.0.

  2. Use InterfaceIndex para recuperar el adaptador de red que desee.

    "SELECT * FROM Win32_NetworkAdapter WHERE InterfaceIndex=" + insertVariableHere

Ejemplos

El ejemplo de código de PowerShell de dos funciones WMI de la Galería de TechNet usa Win32_NetworkAdapter para volver a crear el cmdlet Get-NetAdapter de Windows.

El ejemplo de PowerShell Get-ComputerInfo - Query Computer Info From Local/Remote Computers - (WMI) en techNet Gallery usa varias llamadas al hardware y el software, incluidos los Win32_NetworkAdapter, para mostrar información sobre un sistema local o remoto.

En el ejemplo de código de C# siguiente se usa el espacio de nombres Microsoft.Management.Infrastructure para recuperar los adaptadores de red actuales en el equipo local.

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

En el ejemplo de código de C# siguiente se usa https://msdn.microsoft.com/library/system.management.aspx el espacio de nombres para recuperar los adaptadores de red actuales en el equipo local.

Nota

https://msdn.microsoft.com/library/system.management.aspx contiene las clases originales utilizadas para acceder a WMI; sin embargo, se consideran más lentos y, por lo general, no se escalan, así como sus homólogos de 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();

        }

En el siguiente ejemplo de código VBScript se describe cómo recuperar los adaptadores de red actuales en el equipo local.

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

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista
Servidor mínimo compatible
Windows Server 2008
Espacio de nombres
Root\CIMV2
MOF
CIMWin32.mof
Archivo DLL
CIMWin32.dll

Consulte también

CIM_NetworkAdapter

Clases de hardware del sistema de equipos

Tareas de WMI: Redes

Compatibilidad con IPv6 e IPv4 en WMI