Configuration Manager requêtes spéciales

Le langage WQL (Extended WMI Query Language) prend en charge les requêtes spécifiques à Configuration Manager besoins. Le tableau suivant décrit les requêtes supplémentaires prises en charge.

Array, propriété
Valeurs particulières dans une propriété de tableau.

Classe de base
Valeurs de propriété qui existent dans une classe de base.

Prototype
Définition de classe plutôt que données de classe.

Limitation de la collecte
Données spécifiques à une collection particulière.

Requêtes de propriété array

En raison de la nature des propriétés de tableau, leur inclusion dans une requête WQL étendue peut être quelque peu complexe. Par exemple, considérez la SMS_R_System classe qui inclut la IPAddresses propriété . La IPAddresses propriété est un tableau qui contient une ou plusieurs adresses individuelles. Pour rechercher des ordinateurs avec des adresses IP, vous pouvez spécifier l’une des deux requêtes suivantes.

SELECT * FROM SMS_R_System WHERE IPAddresses = « 2.2.2.2 »

SELECT * FROM SMS_R_System WHERE IPAddresses IN (« 1.1.1.1 », « 2.2.2.2 »)

Requêtes de classe de base

Les requêtes WQL étendues sur une classe de base retournent des instances de toutes les sous-classes. Pour les requêtes abstraites de classe de base, les instances retournées sont toujours des instances des classes dérivées. Par exemple, la requête suivante retourne des instances de classes telles que SMS_SCI_Component et SMS_SCI_Address, qui héritent des propriétés de SMS_SiteControlItem.

SELECT * FROM SMS_SiteControlItem WHERE Sitecode="ABC"

Requêtes prototypes

WQL étendu vous permet de demander que le jeu de résultats contienne une définition de la classe à retourner plutôt que les instances réelles de la classe. Il existe deux résultats possibles à partir de ce type de requête. Dans la plupart des cas, une requête prototype retourne un objet de classe qui contient la définition. Si la requête est une opération JOIN avec plusieurs classes dans l’instruction SELECT, la requête prototype retourne une instance de la classe __Generic.

Bien que les requêtes prototypes soient les plus utiles pour traiter les résultats des opérations JOIN, elles sont prises en charge pour toutes les requêtes. Pour demander une définition de classe comme jeu de résultats, définissez le lFlags paramètre dans IWbemServices::ExecQuery ou IWbemServices::ExecQueryAsync sur WBEM_FLAG_PROTOTYPE.

Requêtes limitant la collecte

Une collection Configuration Manager est un regroupement de ressources telles que des ordinateurs et des utilisateurs. WQL étendu prend en charge les requêtes sur des collections particulières. Il existe deux approches que vous pouvez utiliser pour limiter une requête à une collection particulière :

Définissez la valeur de contexte LimitToCollectionIDs sur la valeur CollectionID requise. Cette valeur de contexte est rendue disponible via le pointeur IWbemContext dans la IWbemServices::ExecQuery méthode vers le nom de la collection.

Spécifiez une opération JOIN interne à l’aide des SMS_CollectionMemberclasses dérivées dans la requête qui est passée à ExecQuery.

La deuxième approche est plus lente, mais c’est la seule approche possible si vous utilisez une application qui utilise l’adaptateur ODBC WMI.

Voir aussi

classes d’association Configuration Manager
propriétés du champ de bits Configuration Manager
Configuration Manager formats de date et d’heure
objets incorporés Configuration Manager
langage de requête WMI étendu Configuration Manager
Vue d’ensemble des objetsConfiguration Manager propriétés différées
À propos des erreursConfiguration Manager la sécurité des objets