Freigeben über


WMI-Datenleser (Task)

Gilt für: SQL Server SSIS Integration Runtime in Azure Data Factory

Der Task WMI-Datenleser führt Abfragen mithilfe von WQL (WMI Query Language) aus, womit Informationen von WMI zu einem Computersystem zurückgegeben werden. Der Task WMI-Datenleser kann für folgende Zwecke verwendet werden:

  • Abfragen der Windows-Ereignisprotokolle auf einem lokalen Computer oder einem Remotecomputer und Schreiben der Informationen in eine Datei oder Variable.

  • Abrufen von Informationen zum Vorhandensein, zum Status oder zu Eigenschaften von Hardwarekomponenten und Ermitteln mithilfe dieser Informationen, ob andere Tasks in der Ablaufsteuerung ausgeführt werden sollten.

  • Abrufen einer Liste der Anwendungen und Ermitteln der installierten Version jeder Anwendung.

Es gibt folgende Möglichkeiten, um den Task WMI-Datenleser zu konfigurieren:

  • Geben Sie den zu verwendenden WMI-Verbindungs-Manager an.

  • Geben Sie die Quelle der WQL-Abfrage an. Die Abfrage kann in einer Taskeigenschaft gespeichert sein, die Abfrage kann aber auch außerhalb des Tasks in einer Variablen oder einer Datei gespeichert sein.

  • Definieren Sie das Format der WQL-Abfrageergebnisse. Der Task unterstützt ein Tabellen-, Eigenschaftsname/Wert-Paar- oder Eigenschaftswertformat.

  • Geben Sie das Ziel der Abfrage an. Das Ziel kann eine Variable oder eine Datei sein.

  • Geben Sie an, ob das Abfrageziel überschrieben, beibehalten oder angefügt wird.

Falls es sich bei der Quelle oder dem Ziel um eine Datei handelt, verwendet der Task WMI-Datenleser einen Dateiverbindungs-Manager zum Herstellen einer Verbindung mit der Datei. Weitere Informationen finden Sie unter Flat File Connection Manager.

Der Task WMI-Datenleser verwendet einen WMI-Verbindungs-Manager zum Herstellen einer Verbindung mit dem Server, von dem er WMI-Informationen liest. Weitere Informationen finden Sie unter WMI Connection Manager.

WQL-Abfrage

WQL ist ein Dialekt von SQL mit Erweiterungen zur Unterstützung der WMI-Ereignisbenachrichtigung und sonstigen WMI-spezifischen Funktionen. Weitere Informationen zu WQL finden Sie in der WMI-Dokumentation in der MSDN Library.

Hinweis

Die WMI-Klassen variieren in den verschiedenen Windows-Versionen.

Die folgende WQL-Abfrage gibt Einträge aus dem Anwendungsereignisprotokoll zurück.

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

Die folgende WQL-Abfrage gibt Informationen zum logischen Datenträger zurück.

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

Die folgende WQL-Abfrage gibt eine Liste der QFE-Updates (Quick Fix Engineering) für das Betriebssystem zurück.

Select * FROM Win32_QuickFixEngineering  

Verfügbare benutzerdefinierte Meldungen für die Protokollierung für den Task 'WMI-Datenleser'

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task WMI-Datenleser aufgelistet. Weitere Informationen finden Sie unter Integration Services-Protokollierung (SSIS).

Protokolleintrag BESCHREIBUNG
WMIDataReaderGettingWMIData Zeigt an, dass das Lesen der WMI-Daten begonnen wurde.
WMIDataReaderOperation Berichtet die vom Task ausgeführte WQL-Abfrage.

Konfiguration des Tasks "WMI-Datenleser"

Eigenschaften können Sie programmgesteuert oder mit dem SSIS -Designer festlegen.

Klicken Sie auf das folgende Thema, um Informationen zu den Eigenschaften zu erhalten, die Sie im SSIS -Designer festlegen können:

Klicken Sie auf das folgende Thema, um Informationen zum programmgesteuerten Festlegen dieser Eigenschaften anzuzeigen:

Klicken Sie auf das folgende Thema, um weitere Informationen zum Festlegen dieser Eigenschaften im SSIS -Designer zu erhalten:

Editor für den Task 'WMI-Datenleser' (Seite Allgemein)

Auf der Seite Allgemein des Dialogfelds Editor für den Task 'WMI-Datenleser' können Sie einen Namen und eine Beschreibung für den Task 'WMI-Datenleser' angeben.

Weitere Informationen zur WMI Query Language (WQL) finden Sie im Thema zur Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) unter Querying with WQL(Abfragen mit WQL) in der MSDN Library.

Tastatur

Name
Geben Sie einen eindeutigen Namen für den Task 'WMI-Datenleser' an. Dieser Name wird im Tasksymbol als Bezeichnung verwendet.

Hinweis

Tasknamen müssen innerhalb eines Pakets eindeutig sein.

Beschreibung
Geben Sie eine Beschreibung für den Task 'WMI-Datenleser' ein.

Editor für den Task 'WMI-Datenleser' (Seite WMI-Optionen)

Auf der Seite WMI-Optionen des Dialogfelds Editor für den Task „WMI-Datenleser“ können Sie die Quelle der WQL-Abfrage (Windows Management Instrumentation Query Language) und das Ziel des Abfrageergebnisses angeben.

Weitere Informationen zur WMI Query Language (WQL) finden Sie im Thema zur Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) unter Querying with WQL(Abfragen mit WQL) in der MSDN Library.

Statische Optionen

WMIConnectionName
Wählen Sie einen vorhandenen WMI-Verbindungs-Manager aus der Liste aus, oder klicken Sie auf <Neue WMI-Verbindung>, um einen neuen Verbindungs-Manager zu erstellen.

Verwandte Themen: WMI-Verbindungs-Manager, WMI-Verbindungs-Manager-Editor

WQLQuerySourceType
Wählen Sie den Quelltyp der WQL-Abfrage aus, die von dem Task ausgeführt wird. Diese Eigenschaft besitzt die in der folgenden Tabelle aufgeführten Optionen.

Wert BESCHREIBUNG
Direkteingabe Legen Sie die Quelle für eine WQL-Abfrage fest. Bei Auswahl dieses Werts wird die dynamische Option WQLQuerySourceTypeangezeigt.
Dateiverbindung Wählen Sie eine Datei aus, in der die WQL-Abfrage enthalten ist. Bei Auswahl dieses Werts wird die dynamische Option WQLQuerySourceTypeangezeigt.
Variable Legen Sie die Quelle für eine Variable fest, die die WQL-Abfrage definiert. Bei Auswahl dieses Werts wird die dynamische Option WQLQuerySourceTypeangezeigt.

OutputType
Geben Sie an, ob es sich bei der Ausgabe um eine Datentabelle, einen Eigenschaftswert oder einen Eigenschaftsnamen und -wert handeln soll.

OverwriteDestination
Gibt an, ob die ursprünglichen Daten in der Zieldatei oder -variablen beibehalten, überschrieben oder an diese angefügt werden sollen.

DestinationType
Wählen Sie den Zieltyp der WQL-Abfrage aus, die von dem Task ausgeführt wird. Diese Eigenschaft besitzt die in der folgenden Tabelle aufgeführten Optionen.

Wert BESCHREIBUNG
Dateiverbindung Wählen Sie eine Datei aus, um die Ergebnisse der WQL-Abfrage darin zu speichern. Bei Auswahl dieses Werts wird die dynamische Option DestinationTypeangezeigt.
Variable Legen Sie die Variable fest, um die Ergebnisse der WQL-Abfrage darin zu speichern. Bei Auswahl dieses Werts wird die dynamische Option DestinationTypeangezeigt.

Dynamische Optionen von WQLQuerySourceType

WQLQuerySourceType = Direct input

WQLQuerySource
Stellen Sie eine Abfrage bereit, oder klicken Sie auf die Schaltfläche mit den Auslassungspunkten (...), und geben Sie eine Abfrage mithilfe des Dialogfelds WQL-Abfrage ein.

WQLQuerySourceType = File connection

WQLQuerySource
Wählen Sie in der Liste einen Dateiverbindungs-Manager aus, oder klicken Sie auf <Neue Verbindung>, um einen neuen Verbindungs-Manager zu erstellen.

Verwandte Themen: Dateiverbindungs-Manager, Dateiverbindungs-Manager-Editor

WQLQuerySourceType = Variable

WQLQuerySource
Wählen Sie eine Variable aus der Liste aus, oder klicken Sie auf <Neue Variable>, um eine neue Variable zu erstellen.

Verwandte Themen: Integration Services-Variablen (SSIS), Hinzufügen von Variablen

Dynamische Optionen von DestinationType

DestinationType = File connection

Ziel
Wählen Sie in der Liste einen Dateiverbindungs-Manager aus, oder klicken Sie auf <Neue Verbindung>, um einen neuen Verbindungs-Manager zu erstellen.

Verwandte Themen: Dateiverbindungs-Manager, Dateiverbindungs-Manager-Editor

DestinationType = Variable

Ziel
Wählen Sie eine Variable aus der Liste aus, oder klicken Sie auf <Neue Variable>, um eine neue Variable zu erstellen.

Verwandte Themen: Integration Services-Variablen (SSIS), Hinzufügen von Variablen

Weitere Informationen

Integration Services-Tasks
Ablaufsteuerung