Attività Lettore di dati WMIWMI Data Reader Task

L'attività Lettore di dati WMI esegue query che utilizzano il linguaggio di query di WMI (Windows Management Instrumentation, Strumentazione gestione Windows) per ottenere da WMI informazioni su un sistema informatico.The WMI Data Reader task runs queries using the Windows Management Instrumentation (WMI) Query Language that returns information from WMI about a computer system. È possibile utilizzare l'attività Lettore di dati WMI per gli scopi seguenti:You can use the WMI Data Reader task for the following purposes:

  • Eseguire query sul registro eventi di Windows di un computer locale o remoto e scrivere le informazioni ottenute in un file o in una variabile.Query the Windows event logs on a local or remote computer and write the information to a file or variable.

  • Ottenere informazioni sulla presenza, lo stato o le proprietà dei componenti hardware e quindi utilizzare tali informazioni per determinare se altre attività nel flusso di controllo devono essere eseguite o meno.Obtain information about the presence, state, or properties of hardware components, and then use this information to determine whether other tasks in the control flow should run.

  • Ottenere un elenco di applicazioni e determinare le versioni installate.Get a list of applications and determine what version of each application is installed.

    Per configurare l'attività Lettore di dati WMI, procedere nel modo seguente:You can configure the WMI Data Reader task in the following ways:

  • Specificare la gestione connessione WMI da utilizzare.Specify the WMI connection manager to use.

  • Specificare l'origine della query WQL.Specify the source of the WQL query. La query può essere archiviata in una proprietà dell'attività o all'esterno dell'attività, in una variabile o in un file.The query can be stored in a task property, or the query can be stored outside the task, in a variable or a file.

  • Definire il formato dei risultati della query WQL.Define the format of the WQL query results. L'attività supporta le tabelle, le coppie nome/valore delle proprietà e i valori di proprietà.The task supports a table, property name/value pair, or property value format.

  • Specificare la destinazione della query,Specify the destination of the query. che può essere costituita da una variabile o da un file.The destination can be a variable or a file.

  • Indicare se la destinazione della query verrà sovrascritta o mantenuta oppure se i nuovi dati verranno accodati a quelli esistenti.Indicate whether the query destination is overwritten, kept, or appended.

    Se la destinazione è un file, l'attività Lettore di dati WMI utilizzerà una gestione connessione file per connettersi al file.If the source or destination is a file, the WMI Data Reader task uses a File connection manager to connect to the file. Per ulteriori informazioni, vedere Flat File Connection Manager.For more information, see Flat File Connection Manager.

    L'attività Lettore di dati WMI utilizza una gestione connessione WMI per connettersi al server da cui legge le informazioni di WMI.The WMI Data Reader task uses a WMI connection manager to connect to the server from which it reads WMI information. Per altre informazioni, vedere Gestione connessione WMI.For more information, see WMI Connection Manager.

Query WQLWQL Query

WQL è un sottolinguaggio di SQL che include estensioni per supportare la notifica degli eventi WMI e altre caratteristiche specifiche di WMI.WQL is a dialect of SQL with extensions to support WMI event notification and other WMI-specific features. Per altre informazioni su WQL, vedere la documentazione di Strumentazione gestione Windows in MSDN Library.For more information about WQL, see the Windows Management Instrumentation documentation in the MSDN Library.

Nota

Le classi WMI variano a seconda della versione di Windows.WMI classes vary between versions of Windows.

La query WQL seguente restituisce le voci contenute nel registro eventi applicazioni.The following WQL query returns entries in the Application log event.

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

La query WQL seguente restituisce informazioni sui dischi logici.The following WQL query returns logical disk information.

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

La query WQL seguente restituisce un elenco degli aggiornamenti QFE (Quick Fix Engineering) applicati al sistema operativo.The following WQL query returns a list of the quick fix engineering (QFE) updates to the operating system.

Select * FROM Win32_QuickFixEngineering  

Messaggi di registrazione personalizzati disponibili nell'attività Lettore di dati WMICustom Logging Messages Available on the WMI Data Reader Task

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Lettore di dati WMI.The following table lists the custom log entries for the WMI Data Reader task. Per altre informazioni, vedere registrazione di Integration Services (SSIS).For more information, see Integration Services (SSIS) Logging.

Voce di logLog entry DescriptionDescription
WMIDataReaderGettingWMIDataWMIDataReaderGettingWMIData Indica che l'attività ha iniziato a leggere dati WMI.Indicates that the task began to read WMI data.
WMIDataReaderOperationWMIDataReaderOperation Specifica la query WQL eseguita dall'attività.Reports the WQL query that the task ran.

Configurazione dell'attività Lettore di dati WMIConfiguration of the WMI Data Reader Task

È possibile impostare le proprietà a livello di programmazione o tramite Progettazione SSISSSIS .You can set properties programmatically or through SSISSSIS Designer.

Per informazioni sulle proprietà che è possibile impostare in Progettazione SSISSSIS , fare clic sull'argomento seguente:For information about the properties that you can set in SSISSSIS Designer, click the following topic:

  • Pagina EspressioniExpressions Page

    Per informazioni sull'impostazione di queste proprietà a livello di codice, fare clic sull'argomento seguente:For information about programmatically setting these properties, click the following topic:

  • WmiDataReaderTask

Per altre informazioni sull'impostazione di queste proprietà in Progettazione SSISSSIS , fare clic sull'argomento seguente:For more information about how to set these properties in SSISSSIS Designer, click the following topic:

Editor attività Lettore di dati WMI (pagina Generale)WMI Data Reader Task Editor (General Page)

Utilizzare la pagina Generale della finestra di dialogo Editor attività Lettore di dati WMI per assegnare un nome e una descrizione all'attività Lettore di dati WMI.Use the General page of the WMI Data Reader Task Editor dialog box to name and describe the WMI Data Reader task.

Per altre informazioni su WQL (WMI Query Language), vedere l'argomento relativo a WMI (Windows Management Instrumentation) Query con WQLin MSDN Library.For more information about WMI Query Language (WQL), see the Windows Management Instrumentation topic, Querying with WQL, in the MSDN Library.

OpzioniOptions

NomeName
Consente di digitare un nome univoco per l'attività Lettore di dati WMI.Provide a unique name for the WMI Data Reader task. Tale nome viene utilizzato come etichetta nell'icona dell'attività.This name is used as the label in the task icon.

Nota

I nomi delle attività devono essere univoci all'interno di un pacchetto.Task names must be unique within a package.

DescriptionDescription
Consente di digitare una descrizione dell'attività Lettore di dati WMI.Type a description of the WMI Data Reader task.

Editor attività Lettore di dati WMI (pagina Opzioni WMI)WMI Data Reader Task Editor (WMI Options Page)

Usare la pagina Opzioni WMI della finestra di dialogo Editor attività Lettore di dati WMI per specificare l'origine della query WQL (Windows Management Instrumentation Query Language) e la destinazione del risultato della query.Use the WMI Options page of the WMI Data Reader Task Editor dialog box to specify the source of the Windows Management Instrumentation Query Language (WQL) query and the destination of the query result.

Per altre informazioni su WQL (WMI Query Language), vedere l'argomento relativo a WMI (Windows Management Instrumentation) Query con WQLin MSDN Library.For more information about WMI Query Language (WQL), see the Windows Management Instrumentation topic, Querying with WQL, in the MSDN Library.

Opzioni staticheStatic Options

WMIConnectionNameWMIConnectionName
Selezionare una gestione connessione WMI nell'elenco oppure fare clic su < nuova connessione WMI... > per creare una nuova gestione connessione.Select a WMI connection manager in the list, or click <New WMI Connection…> to create a new connection manager.

Argomenti correlati: Gestione connessione WMI, Editor gestione connessione WMIRelated Topics: WMI Connection Manager, WMI Connection Manager Editor

WQLQuerySourceTypeWQLQuerySourceType
Consente di selezionare il tipo di origine della query WQL eseguita dall'attività.Select the source type of the WQL query that the task runs. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente.This property has the options listed in the following table.

ValoreValue DescriptionDescription
Input direttoDirect input Consente di impostare l'origine su una query WQL.Set the source to a WQL query. Selezionando questo valore viene visualizzata l'opzione dinamica WQLQuerySourceType.Selecting this value displays the dynamic option WQLQuerySourceType.
Connessione fileFile connection Consente di selezionare un file contenente la query WQL.Select a file that contains the WQL query. Selezionando questo valore viene visualizzata l'opzione dinamica WQLQuerySourceType.Selecting this value displays the dynamic option WQLQuerySourceType.
VariabileVariable Consente di impostare l'origine su una variabile che definisce la query WQL.Set the source to a variable that defines the WQL query. Selezionando questo valore viene visualizzata l'opzione dinamica WQLQuerySourceType.Selecting this value displays the dynamic option WQLQuerySourceType.

OutputTypeOutputType
Consente di specificare se l'output deve essere una tabella di dati, un valore di proprietà o un nome e valore di proprietà.Specify whether the output should be a data table, property value, or property name and value.

OverwriteDestinationOverwriteDestination
Consente di specificare se mantenere, sovrascrivere o accodare ai dati originali nel file o nella variabile di destinazione.Specifies whether to keep, overwrite, or append to the original data in the destination file or variable.

DestinationTypeDestinationType
Consente di selezionare il tipo di destinazione della query WQL eseguita dall'attività.Select the destination type of the WQL query that the task runs. Per questa proprietà sono disponibili le opzioni elencate nella tabella seguente.This property has the options listed in the following table.

ValoreValue DescriptionDescription
Connessione fileFile connection Selezionare un file in cui salvare i risultati della query WQL.Select a file to save the results of the WQL query in. Selezionando questo valore viene visualizzata l'opzione dinamica DestinationType.Selecting this value displays the dynamic option, DestinationType.
VariabileVariable Impostare la variabile in cui archiviare i risultati della query WQL.Set the variable to store the results of the WQL query in. Selezionando questo valore viene visualizzata l'opzione dinamica DestinationType.Selecting this value displays the dynamic option, DestinationType.

Opzioni dinamiche di WQLQuerySourceTypeWQLQuerySourceType Dynamic Options

WQLQuerySourceType = Input direttoWQLQuerySourceType = Direct input

WQLQuerySourceWQLQuerySource
Consente di specificare una query o di immettere una query nella finestra di dialogo Query WQL visualizzata facendo clic sul pulsante (...).Provide a query, or click the ellipsis (…) and enter a query using the WQL Query dialog box.

WQLQuerySourceType = Connessione fileWQLQuerySourceType = File connection

WQLQuerySourceWQLQuerySource
Selezionare una gestione connessione File nell'elenco oppure fare clic su < nuova connessione... > per creare una nuova gestione connessione.Select a File connection manager in the list, or click <New connection...> to create a new connection manager.

Argomenti correlati: File Connection Manager, File Connection Manager EditorRelated Topics: File Connection Manager, File Connection Manager Editor

WQLQuerySourceType = VariabileWQLQuerySourceType = Variable

WQLQuerySourceWQLQuerySource
Selezionare una variabile nell'elenco oppure fare clic su < nuova variabile... > per creare una nuova variabile.Select a variable in the list, or click <New variable...> to create a new variable.

Argomenti correlati: Variabili di Integration Services (SSIS), Aggiungi variabileRelated Topics: Integration Services (SSIS) Variables, Add Variable

Opzioni dinamiche di DestinationTypeDestinationType Dynamic Options

DestinationType = Connessione fileDestinationType = File connection

DestinazioneDestination
Selezionare una gestione connessione File nell'elenco oppure fare clic su < nuova connessione... > per creare una nuova gestione connessione.Select a File connection manager in the list, or click <New connection...> to create a new connection manager.

Argomenti correlati: File Connection Manager, File Connection Manager EditorRelated Topics: File Connection Manager, File Connection Manager Editor

DestinationType = VariabileDestinationType = Variable

DestinazioneDestination
Selezionare una variabile nell'elenco oppure fare clic su < nuova variabile... > per creare una nuova variabile.Select a variable in the list, or click <New variable...> to create a new variable.

Argomenti correlati: Variabili di Integration Services (SSIS), Aggiungi variabileRelated Topics: Integration Services (SSIS) Variables, Add Variable

Vedere ancheSee Also

Attività di Integration Services Integration Services Tasks
Flusso di controlloControl Flow