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
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 |