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
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:
- Win32_PnPEntity
- Win32_ComputerSystem
- Win32_NetworkAdapterConfiguration
- Win32_IRQResource
- Win32_DeviceMemoryAddress
- Win32_PortResource
- Win32_NetworkProtocol
- Win32_SystemDriver
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:
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.
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 |
|
| Archivo DLL |
|
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de