CIM_NetworkAdapter clase
La clase CIM_NetworkAdapter es una clase abstracta que define conceptos generales de hardware de red (por ejemplo, dirección permanente o velocidad de funcionamiento). La información se transmite mediante la asociación CIM_DeviceSAPImplementation .
Los adaptadores de red y los puntos de conexión relacionados representan la posibilidad de conectividad entre los sistemas del mismo nivel. La posibilidad de conectividad es significativamente diferente de las relaciones principal o subordinada y de controlador o controlada por de CIM_Controller. Sin embargo, en ocasiones, un único dispositivo actúa como un adaptador de red y un controlador, por ejemplo, cuando un adaptador de canal de fibra funciona como controlador SCSI del sistema informático. En cuyo caso, los aspectos del dispositivo están orientados a la red y otros están orientados a la controladora. Se deben crear instancias de las clases de controlador y adaptador y también se debe crear una relación de identidad de dispositivo para vincular los distintos aspectos del dispositivo.
Importante
Las clases CIM (Grupo de tareas de administración distribuida) DMTF (Common Information Model) son las clases primarias en las que se compilan las clases WMI. WMI actualmente solo admite los esquemas de versión cim 2.x.
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
[Abstract, UUID("{8502C532-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_NetworkAdapter : CIM_LogicalDevice
{
boolean AutoSense;
uint16 Availability;
string Caption;
uint32 ConfigManagerErrorCode;
boolean ConfigManagerUserConfig;
string CreationClassName;
string Description;
string DeviceID;
boolean ErrorCleared;
string ErrorDescription;
datetime InstallDate;
uint32 LastErrorCode;
uint64 MaxSpeed;
string Name;
string NetworkAddresses[];
string PermanentAddress;
string PNPDeviceID;
uint16 PowerManagementCapabilities[];
boolean PowerManagementSupported;
uint64 Speed;
string Status;
uint16 StatusInfo;
string SystemCreationClassName;
string SystemName;
};
Miembros
La clase CIM_NetworkAdapter tiene estos tipos de miembros:
Métodos
La clase CIM_NetworkAdapter tiene estos métodos.
Método | Descripción |
---|---|
Restablecer | Solicita un restablecimiento del dispositivo lógico. No implementado por WMI. |
SetPowerState | Define el estado de energía deseado para un dispositivo lógico y cuándo se debe colocar un dispositivo en ese estado. No implementado por WMI. |
Propiedades
La clase CIM_NetworkAdapter tiene estas propiedades.
-
AutoSense
-
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
Si es TRUE, el adaptador de red puede determinar automáticamente la velocidad u otras características de comunicaciones de los medios de red conectados.
-
-
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)
-
Advertencia (4)
-
En prueba (5)
-
No aplicable (6)
-
Apagado (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 modo 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 modo 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")
Breve descripción textual del objeto.
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 notifica incorrectamente 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 gratuitos 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 de este dispositivo. (18)
Los controladores de dispositivo deben reinstalarse.
Error al usar el cargador de VxD. (19)
Es posible que el registro esté dañado. (20)
El registro puede estar 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 no es eficaz, 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 no es eficaz, 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 instalados todos sus controladores.
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 ha dado 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 otro dispositivo está usando.
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 clase o subclase usada en la creación de una instancia. Cuando se usa con otras propiedades clave de la clase , esta propiedad permite identificar todas las instancias de la 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 textual del objeto.
Esta propiedad se hereda de CIM_ManagedSystemElement.
Deviceid
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: CIM_Key
Dirección u otra información de identificación para asignar un nombre único al dispositivo lógico.
Esta propiedad se hereda de CIM_LogicalDevice.
ErrorCleared
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
Si es TRUE, ahora se borra el error notificado en la propiedad LastErrorCode .
Esta propiedad se hereda de CIM_LogicalDevice.
ErrorDescription
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Cadena de forma libre que proporciona información sobre el error registrado en la propiedad LastErrorCode y las acciones correctivas que se van a realizar.
Esta propiedad se hereda de CIM_LogicalDevice.
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.
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.
MaxSpeed
-
Tipo de datos: uint64
-
Tipo de acceso: solo lectura
-
Calificadores: unidades ("bits por segundo")
Velocidad máxima, en bits por segundo (BPS), para el adaptador de red.
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, esta propiedad se puede invalidar para que sea una propiedad de clave.
Esta propiedad se hereda de CIM_ManagedSystemElement.
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")
Lista de direcciones de red para un adaptador.
PermanentAddress
-
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. La dirección codificada de forma rígida se puede cambiar con una actualización de firmware o una configuración de software. Si se cambia, el campo se debe actualizar cuando se realiza el cambio. Esta propiedad debe dejarse en blanco si no existe ninguna dirección codificada de forma rígida para el adaptador de red.
PNPDeviceID
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Esquema ("Win32")
Win32 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 energía 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 CIM_LogicalDevice primaria y se puede implementar. Para más información, vea Diseño de clases de formato de Managed Object Format (MOF).
Power Cycling 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)
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, es decir, poner en un estado de ahorro de energía. Si es FALSE, el valor entero 1 ("No admitido") debe ser la única entrada de la matriz PowerManagementCapabilities .
Esta propiedad no indica si las características de administración de energía están habilitadas actualmente o si están habilitadas, qué características se admiten. Para obtener más información, consulte la matriz PowerManagementCapabilities . Esta propiedad se hereda de CIM_LogicalDevice.
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 BPS. 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.
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
Nombre de clase de creación del sistema 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.
Observaciones
La clase CIM_NetworkAdapter se deriva de CIM_LogicalDevice.
WMI no implementa esta clase. Para las clases derivadas de CIM_NetworkAdapter, consulte Clases Win32.
Esta documentación se deriva de las descripciones de clase CIM publicadas por DMTF. Microsoft puede haber realizado cambios para corregir errores menores, cumplir los estándares de documentación del SDK de Microsoft o proporcionar más información.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible |
Windows Vista |
Servidor mínimo compatible |
Windows Server 2008 |
Espacio de nombres |
Root\CIMV2 |
MOF |
|
Archivo DLL |
|