Interrogation avec WQL

Le langage de requête WMI (WQL) est un sous-ensemble du langage de requête structuré standard de l'ANSI SQL (American National Standards Institute) avec des modifications sémantiques mineures pour prendre en charge WMI.

Pour obtenir la liste complète des mots clés WQL pris en charge, consultez WQL (SQL pour WMI). L’utilisation de mots clés SQL pour les noms d’objets ou de propriétés peut empêcher l’analyse d’une requête. Les mots-clés SQL suivants sont restreints : NULL, TRUE et FALSE.

Les requêtes peuvent utiliser la clause WHERE pour l’extension et la personnalisation, même si ce n’est pas obligatoire. La clause WHERE est composée d’une propriété ou d’un mot clé, d’un opérateur et d’une constante. Toutes les clauses WHERE doivent spécifier l’un des opérateurs prédéfinis inclus dans WQL. Pour plus d’informations sur la syntaxe, consultez Syntaxe WHERE. Pour plus d’informations sur les opérateurs WQL valides, consultez Opérateurs WQL.

Comme pour les autres chaînes de requête SQL, vous pouvez interrompre vos requêtes.

WQL prend en charge les types de requêtes suivants :

• Requêtes de données

  Les requêtes de données sont utilisées pour récupérer des instances de classe et des associations de données. Il s’agit du type de requête le plus couramment utilisé dans les scripts et applications WMI. Pour plus d’informations sur la syntaxe des requêtes de données, consultez Demande de données d’instance de classe. Pour plus d’informations sur les associations, consultez Déclaration d’une classe d’association.

  Notes

  WQL ne prend pas en charge les requêtes des types de données de tableaux.

   

  L’exemple de requête de données suivant demande le fichier journal d’événements nommé « Application » à toutes les instances de Win32_NTLogEvent.

  strComputer = "." 
  Set objWMIService = GetObject("winmgmts:\\" _
      & strComputer & "\root\CIMV2") 
  Set colItems = objWMIService.ExecQuery( _
      "SELECT * FROM Win32_NTLogEvent " _
      & "WHERE Logfile = 'Application'",,48)
  

• Requêtes d’événements

  Les consommateurs utilisent des requêtes d’événements pour s’inscrire et recevoir une notification d’événements. Les fournisseurs d’événements utilisent des requêtes d’événements pour s’inscrire afin de prendre en charge un ou plusieurs événements. Pour plus d’informations sur les requêtes d’événements, consultez Réception des notifications d’événements.

  L’exemple suivant de requête d’événement par un consommateur d’événements temporaire demande une notification lorsqu’une nouvelle instance d’une classe dérivée de Win32_NTLogEvent est créée.

  strComputer = "." 
  Set objWMIService = GetObject("winmgmts:\\" _
      & strComputer & "\root\CIMV2") 
  Set objEvents = objWMIService.ExecNotificationQuery _
  ("SELECT * FROM __InstanceModificationEvent WITHIN 10 WHERE " & _
      "TargetInstance ISA 'Win32_Service'" & _
      " AND TargetInstance._Class = 'win32_TerminalService'")
  
  i = TRUE
  Do While i = TRUE
      Set strReceivedEvent = objEvents.NextEvent
  
      'report an event
      Wscript.Echo "An event has occurred."
  Loop
  

• Requêtes de schéma

  Les requêtes de schéma sont utilisées pour récupérer des définitions de classes (plutôt que des instances de classe) et des associations de schémas. Les fournisseurs de classes utilisent des requêtes de schéma pour spécifier les classes qu’ils prennent en charge au moment de leur enregistrement. Pour plus d’informations sur les requêtes de schéma, consultez Récupération de définitions de classes.

  L’exemple de requête de schéma suivant montre la syntaxe spéciale.

  SELECT * FROM meta_class WHERE __this ISA "Win32_BaseService"
  

Rubriques connexes

Format date et heure WMI