Partager via


Tâche Lecteur de données WMI

S’applique à : SQL Server SSIS Integration Runtime dans Azure Data Factory

La tâche Lecteur de données WMI exécute des requêtes au moyen du langage de requête WMI (Windows Management Instrumentation) qui retournent des informations à partir de WMI sur un système informatique. Vous pouvez utiliser la tâche Lecteur de données WMI pour effectuer les opérations suivantes :

  • Interrogation des journaux des événements Windows sur un ordinateur local ou distant et écriture des informations dans un fichier ou une variable.

  • Obtention d'informations sur la présence, l'état ou les propriétés de composants matériels, puis utilisation de ces informations pour déterminer si d'autres tâches du flux de contrôle doivent être exécutées.

  • Obtention d'une liste d'applications et détermination de la version de chaque application installée.

Vous pouvez configurer la tâche Lecteur de données WMI de plusieurs manières :

  • Spécifiez le gestionnaire de connexions WMI à utiliser.

  • Spécifiez la source de la requête WQL. La requête peut être stockée dans une propriété de tâche ou en dehors de la tâche, dans une variable ou un fichier.

  • Définissez le format des résultats de requêtes WQL. La tâche prend en charge un format de table, de paire nom/valeur de propriété ou de valeur de propriété.

  • Spécifiez la destination de la requête. La destination peut être une variable ou un fichier.

  • Indiquez si les résultats sont ajoutés à la destination de la requête ou si celle-ci est remplacée ou conservée.

Si la source ou la destination est un fichier, la tâche Lecteur de données WMI utilise un gestionnaire de connexions de fichiers pour se connecter au fichier. Pour plus d'informations, consultez Flat File Connection Manager.

La tâche Lecteur de données WMI utilise un gestionnaire de connexions WMI pour se connecter au serveur à partir duquel elle lit les informations WMI. Pour plus d'informations, consultez WMI Connection Manager.

Requête WQL

WQL est un dialecte de SQL avec des extensions qui permettent de prendre en charge la notification d'événement WMI et d'autres fonctionnalités spécifiques à WMI. Pour plus d'informations sur WQL, consultez la documentation Windows Management Instrumentation dans MSDN Library.

Notes

Les classes WMI varient d'une version de Windows à l'autre.

La requête WQL suivante retourne des entrées dans le journal des événements d'application.

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

La requête WQL suivante retourne des informations sur les disques logiques.

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

La requête WQL suivante retourne une liste des mises à jour QFE (Quick Fix Engineering) du système d'exploitation.

Select * FROM Win32_QuickFixEngineering  

Messages de journalisation personnalisés disponibles dans la tâche Lecteur de données WMI

Le tableau suivant répertorie les entrées de journal personnalisées de la tâche Lecteur de données WMI. Pour plus d’informations, consultez Journalisation d’Integration Services (SSIS).

Entrée du journal Description
WMIDataReaderGettingWMIData Indique que la tâche a commencé la lecture des données WMI.
WMIDataReaderOperation Indique la requête WQL que la tâche a exécutée.

Configuration de la tâche Lecteur de données WMI

Vous pouvez définir les propriétés par programmation ou par le biais du concepteur SSIS .

Pour plus d'informations sur les propriétés définissables dans le concepteur SSIS , cliquez sur la rubrique suivante :

Pour plus d'informations sur la définition par programmation de ces propriétés, cliquez sur la rubrique suivante :

Pour plus d'informations sur la définition de ces propriétés dans le concepteur SSIS , cliquez sur la rubrique suivante :

Éditeur de tâche Lecteur de données WMI (page Général)

La page Général de la boîte de dialogue Éditeur de tâche Lecteur de données WMI permet de nommer et décrire la tâche Lecteur de données WMI.

Pour plus d’informations sur le langage de requêtes WMI (WQL), consultez la rubrique Requêtes avec WQLdans la documentation Windows Management Instrumentation de la bibliothèque MSDN.

Options

Nom
Fournit un nom unique pour la tâche Lecteur de données WMI. Ce nom sert d'étiquette à l'icône de la tâche.

Notes

Les noms de tâche doivent être uniques dans un package.

Description
Tapez une description de la tâche Lecteur de données WMI.

Éditeur de tâche Lecteur de données WMI (page Options WMI)

Utilisez la page Options WMI de la boîte de dialogue Éditeur de tâche Lecteur de données WMI pour définir la source de la requête WQL (Windows Management Instrumentation Query Language) et la destination du résultat de la requête.

Pour plus d’informations sur le langage de requêtes WMI (WQL), consultez la rubrique Requêtes avec WQLdans la documentation Windows Management Instrumentation de la bibliothèque MSDN.

Options statiques

WMIConnectionName
Sélectionnez un gestionnaire de connexions WMI dans la liste ou cliquez sur <Nouvelle connexion WMI...> pour en créer un.

Rubriques connexes : Gestionnaire de connexions WMI, Éditeur du gestionnaire de connexions WMI

WQLQuerySourceType
Sélectionnez le type de la source de la requête WQL que la tâche exécute. Cette propriété dispose des options répertoriées dans le tableau suivant.

Valeur Description
Entrée directe Définit la source d'une requête WQL. Si vous sélectionnez cette valeur, l'option dynamique WQLQuerySourceTypes'affiche.
Connexion de fichiers Sélectionnez un fichier qui contient la requête WQL. Si vous sélectionnez cette valeur, l'option dynamique WQLQuerySourceTypes'affiche.
Variable Définissez la source dans une variable qui définit la requête WQL. Si vous sélectionnez cette valeur, l'option dynamique WQLQuerySourceTypes'affiche.

OutputType
Indiquez si la sortie doit être une table de données, une valeur de propriété ou un nom et une valeur de propriété.

OverwriteDestination
Indique s'il faut conserver ou remplacer les données d'origine dans le fichier ou la variable de destination, ou leur ajouter des données.

DestinationType
Sélectionnez le type de la destination de la requête WQL que la tâche exécute. Cette propriété dispose des options répertoriées dans le tableau suivant.

Valeur Description
Connexion de fichiers Sélectionnez un fichier pour y enregistrer le résultat de la requête WQL. Cette valeur affiche l'option dynamique DestinationType.
Variable Définissez la variable de stockage du résultat de la requête WQL. Cette valeur affiche l'option dynamique DestinationType.

Options dynamiques WQLQuerySourceType

WQLQuerySourceType = Entrée directe

WQLQuerySource
Fournissez une requête ou cliquez sur le bouton de sélection (...) et entrez une requête en utilisant la boîte de dialogue Requête WQL.

WQLQuerySourceType = Connexion de fichiers

WQLQuerySource
Sélectionnez un gestionnaire de connexions de fichier dans la liste ou cliquez sur <Nouvelle connexion WMI...> pour en créer un.

Rubriques connexes : File Gestionnaire de connexions, Rédacteur File Gestionnaire de connexions

WQLQuerySourceType = Variable

WQLQuerySource
Sélectionnez une variable dans la liste ou cliquez sur <Nouvelle variable...> pour en créer une.

Rubriques connexes :Variables Integration Services (SSIS), Ajouter une variable

Options dynamiques DestinationType

DestinationType = Connexion de fichiers

Destination
Sélectionnez un gestionnaire de connexions de fichiers dans la liste ou cliquez sur <Nouvelle connexion...> pour en créer un.

Rubriques connexes : File Gestionnaire de connexions, Rédacteur File Gestionnaire de connexions

DestinationType = Variable

Destination
Sélectionnez une variable dans la liste ou cliquez sur <Nouvelle variable...> pour en créer une.

Rubriques connexes :Variables Integration Services (SSIS), Ajouter une variable

Voir aussi

Tâches Integration Services
Flux de contrôle