Clase __EventFilter

El registro de un consumidor de eventos permanente requiere una instancia de la clase del sistema __EventFilter.

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

Sintaxis

class __EventFilter : __IndicationRelated
{
  uint8  CreatorSID[] = {1,1,0,0,0,0,0,5,18,0,0,0};
  string EventAccess;
  string EventNamespace;
  string Name;
  string Query;
  string QueryLanguage;
};

Miembros

La clase __EventFilter tiene estos tipos de miembros:

• Propiedades

Propiedades

La clase __EventFilter tiene estas propiedades.

CreatorSID

Tipo de datos: matriz uint8

Tipo de acceso: lectura/escritura

Identificador de seguridad (SID) que identifica de forma única al usuario que crea este filtro. Instrumental de administración de Windows (WMI) almacena el SID del usuario que crea una instancia de __EventFilter o el SID de administrador, según el sistema operativo. Para más información, consulte Enlazar un filtro de eventos con un consumidor lógico y Supervisión y respuesta a eventos con consumidores estándar.

EventAccess

Tipo de datos: cadena

Tipo de acceso: lectura/escritura

Descriptor de seguridad (SD) en Lenguaje de definición de descriptor de seguridad (SDDL) que controla el acceso a los eventos entregados al filtro. Use esta propiedad para especificar que solo se pueden entregar eventos en el contexto de seguridad de cuentas específicas a este filtro. Por ejemplo, un consumidor de eventos permanente puede borrar los registros de seguridad solo cuando un usuario específico genera un evento específico. Para especificar quién puede publicar eventos en este filtro, use la máscara WBEM_RIGHT_PUBLISH en la entrada de control de acceso (ACE) para la propiedad SECURITY_DESCRIPTOR. Para obtener más información, consulte Lenguaje de definición de descriptor de seguridad. Para obtener más información sobre las constantes usadas para establecer este descriptor de seguridad, consulte Constantes de seguridad de WMI. Para obtener más información y ejemplos, consulte Recibir eventos de forma segura.

Puede configurar un descriptor de seguridad de acceso a eventos para permitir que un evento se entregue solo cuando la cuenta del sistema local genera el evento. Para obtener más información sobre cómo crear el descriptor de seguridad y autorizar el acceso, consulte Control de acceso.

Ejemplo: la siguiente cadena SDDL solo permite a los administradores proporcionar eventos al filtro. El derecho necesario para proporcionar eventos es WBEM_RIGHT_PUBLISH (x80).

O:BAG:BAD:(A;;0x80;;;BA)

EventNamespace

Tipo de datos: cadena

Tipo de acceso: lectura/escritura

Espacio de nombres de la instancia de evento que se usa para las suscripciones de recorrido entre espacios de nombres.

Nombre

Tipo de datos: cadena

Tipo de acceso: lectura/escritura

Calificadores: Key

Identificador único de un filtro de eventos. Dado que solo WMI usa internamente un filtro de eventos, se recomienda establecer esta propiedad en un identificador único global (GUID) convertido en una cadena. Sin embargo, los consumidores pueden usar cualquier esquema privado para un nombre de filtro, siempre que no haya ningún conflicto con otros filtros.

Consultar

Tipo de datos: cadena

Tipo de acceso: lectura/escritura

Consulta de eventos del lenguaje de consulta de Instrumental de administración de Windows (WQL) que especifica el conjunto de eventos para la notificación del consumidor y las condiciones específicas para la notificación.

QueryLanguage

Tipo de datos: cadena

Tipo de acceso: lectura/escritura

Lenguaje usado para la consulta. Dado que WMI actualmente solo admite el Lenguaje de consulta WMI (WQL) como lenguaje de consulta, esta propiedad debe establecerse en "WQL".

Comentarios

La clase __EventFilter se deriva de __IndicationRelated.

Ejemplos

El ejemplo de PowerShell Create Permanent WMI Event registration to monitor files (Crear un registro de eventos de WMI permanente para supervisar archivos) en la Galería de TechNet usa __EventFilter como parte de un script complejo para configurar un registro de eventos WMI permanente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Todos los espacios de nombres WMI

Consulte también

__IndicationRelated

Clases del sistema de WMI

Crear un filtro de eventos

Recibir eventos en todo momento

Supervisión y respuesta a eventos con consumidores estándar

Supervisión de eventos

Clases de consumidor estándar

Proteger eventos de WMI