Tarea Lector de datos WMI

Se aplica a:SQL Server SSIS Integration Runtime en Azure Data Factory

La tarea Lector de datos WMI ejecuta consultas mediante el Lenguaje de consulta del Instrumental de administración de Windows (WMI), que devuelve información de WMI sobre un sistema informático. Puede usar la tarea Lector de datos WMI para los siguientes fines:

  • Realizar consultas de los registros de eventos de Windows en un equipo local o remoto y escribir la información en un archivo o variable.

  • Obtener información sobre la presencia, estado o propiedades de componentes del hardware y usar posteriormente esta información para determinar si se deben ejecutar otras tareas en el flujo de control.

  • Obtener una lista de las aplicaciones y determinar qué versión de cada aplicación está instalada.

Puede configurar la tarea Lector de datos WMI de las maneras siguientes:

  • Especificar el administrador de conexiones WMI que se debe usar.

  • Especificar el origen de la consulta WQL. La consulta se puede almacenar en una propiedad de tarea, o bien fuera de la tarea, en una variable o archivo.

  • Definir el formato de los resultados de la consulta WQL. La tarea admite una tabla, par de nombre/valor de la propiedad o formato de valor de propiedad.

  • Especificar el destino de la consulta. El destino puede ser una variable o un archivo.

  • Indicar si el destino de la consulta se sobrescribe, se conserva o anexa.

Si el origen o destino es un archivo, la tarea Lector de datos WMI usa un administrador de conexiones de archivo para conectarse al archivo. Para más información, consulte Flat File Connection Manager.

La tarea Lector de datos WMI usa un administrador de conexiones WMI para conectarse al servidor desde el cual lee la información de WMI. Para más información, consulte WMI Connection Manager.

WQL Query

WQL es un dialecto de SQL con extensiones para admitir la notificación de eventos de WMI y otras características específicas de WMI. Para obtener más información sobre WQL, vea la documentación sobre Instrumental de administración de Windows en MSDN Library.

Nota

Las clases de WMI varían en las diferentes versiones de Windows.

La siguiente consulta WQL devuelve entradas en el evento de registro de la aplicación.

SELECT * FROM Win32_NTLogEvent WHERE LogFile = 'Application' AND (SourceName='SQLISService' OR SourceName='SQLISPackage') AND TimeGenerated > '20050117'  

La siguiente consulta WQL devuelve información de disco lógica.

SELECT FreeSpace, DeviceId, Size, SystemName, Description FROM Win32_LlogicalDisk  

La siguiente consulta WQL devuelve una lista de las actualizaciones de Ingeniería de corrección rápida (QFE) al sistema operativo.

Select * FROM Win32_QuickFixEngineering  

Mensajes de registro personalizados disponibles en la tarea Lector de datos WMI

La siguiente tabla contiene las entradas del registro personalizadas para la tarea Lector de datos WMI. Para más información, consulte Registro de Integration Services (SSIS).

Entrada del registro Descripción
WMIDataReaderGettingWMIData Indica que la tarea inició la lectura de datos WMI.
WMIDataReaderOperation Informa de la consulta WQL que ejecutó la tarea.

Configuración de la tarea Lector de datos WMI

Puede establecer propiedades mediante programación o a través del Diseñador SSIS .

Para obtener información acerca de las propiedades que puede establecer en el Diseñador SSIS , haga clic en el tema siguiente:

Para obtener información sobre cómo establecer estas propiedades mediante programación, haga clic en el tema siguiente:

Para obtener más información sobre cómo establecer estas propiedades en el Diseñador SSIS , haga clic en el siguiente tema:

Editor de la tarea Lector de datos WMI (página General)

Utilice la página General del cuadro de diálogo Editor de la tarea Lector de datos WMI para asignar un nombre a la tarea Lector de datos WMI y describirla.

Para más información sobre el lenguaje de consulta de WMI (WQL), vea el tema sobre Instrumental de administración de Windows, Querying with WQL(Realizar consultas con WQL), en MSDN Library.

Opciones

Nombre
Proporcione un nombre único para la tarea Lector de datos WMI. Este nombre se utiliza como etiqueta en el icono de tarea.

Nota

Los nombres de tarea deben ser únicos en un paquete.

Descripción
Escriba una descripción de la tarea Lector de datos WMI.

Editor de la tarea Lector de datos WMI (página Opciones WMI)

Use la página Opciones WMI del cuadro de diálogo Editor de la tarea Lector de datos WMI para especificar el origen de la consulta WQL (Lenguaje de consulta de Instrumental de administración de Windows) y el destino del resultado de la consulta.

Para más información sobre el lenguaje de consulta de WMI (WQL), vea el tema sobre Instrumental de administración de Windows, Querying with WQL(Realizar consultas con WQL), en MSDN Library.

Opciones estáticas

WMIConnectionName
Seleccione un administrador de conexiones WMI de la lista, o bien haga clic en <Nueva conexión WMI…> para crear un administrador de conexiones.

Temas relacionadosAdministrador de conexiones WMI, Editor del administrador de conexiones WMI

WQLQuerySourceType
Seleccione el tipo de origen de la consulta WQL que ejecuta la tarea. Esta propiedad presenta las opciones indicadas en la siguiente tabla.

Value Descripción
Entrada directa Establezca el origen en una consulta WQL. Al seleccionar este valor se muestra la opción dinámica WQLQuerySourceType.
Conexión de archivos Seleccione el archivo que contiene la consulta WQL. Al seleccionar este valor se muestra la opción dinámica WQLQuerySourceType.
Variable Establezca el origen en una variable que defina la consulta WQL. Al seleccionar este valor se muestra la opción dinámica WQLQuerySourceType.

OutputType
Especifique si la salida debe ser una tabla de datos, un valor de propiedad o un valor y nombre de propiedad.

OverwriteDestination
Especifica si mantener, sobrescribir o anexar a los datos originales en el archivo de destino o variable.

DestinationType
Seleccione el tipo de destino de la consulta WQL que ejecuta la tarea. Esta propiedad presenta las opciones indicadas en la siguiente tabla.

Value Descripción
Conexión de archivos Seleccione un archivo donde guardar los resultados de la consulta WQL. Al seleccionar este valor se muestra la opción dinámica DestinationType.
Variable Establezca la variable donde almacenar los resultados de la consulta WQL. Al seleccionar este valor se muestra la opción dinámica DestinationType.

Opciones dinámicas WQLQuerySourceType

WQLQuerySourceType = Entrada directa

WQLQuerySource
Proporcione una consulta, o bien haga clic en los puntos suspensivos (…) y escriba una consulta con el cuadro de diálogo Consulta WQL.

WQLQuerySourceType = Conexión de archivos

WQLQuerySource
Seleccione un administrador de conexiones de archivos de la lista, o bien haga clic en <Nueva conexión…> para crear un administrador de conexiones.

Temas relacionados:File Connection Manager, File Connection Manager Editor

WQLQuerySourceType = Variable

WQLQuerySource
Seleccione una variable de la lista, o bien haga clic en <Nueva variable…> para crear una.

Temas relacionados:Variables de Integration Services (SSIS), Agregar variable

Opciones dinámicas DestinationType

DestinationType = Conexión de archivos

Destino
Seleccione un administrador de conexiones de archivos de la lista, o bien haga clic en <Nueva conexión…> para crear un administrador de conexiones.

Temas relacionados:File Connection Manager, File Connection Manager Editor

DestinationType = Variable

Destino
Seleccione una variable de la lista, o bien haga clic en <Nueva variable…> para crear una.

Temas relacionados:Variables de Integration Services (SSIS), Agregar variable

Consulte también

Tareas de Integration Services
Flujo de control