Requêtes spéciales du Configuration Manager

Le langage de requête WMI étendu (WQL) prend en charge les requêtes spécifiques aux besoins de Configuration Manager. Le tableau suivant décrit les requêtes supplémentaires prises en charge.

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

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

Prototype Une définition de classe plutôt que des données de classe.

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

Requêtes de propriétés de tableau

En raison de la nature des propriétés de tableau, les inclure dans une requête WQL étendue peut être quelque peu complexe. Par exemple, considérons 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 interroger 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 renvoient des instances de toutes les sous-classes. Pour les requêtes de classes de base abstraites, les instances renvoyées sont toujours des instances des classes dérivées. Par exemple, la requête suivante renvoie des instances de classes telles que SMS_SCI_Component et SMS_SCI_Address, qui héritent de propriétés de SMS_SiteControlItem.

SELECT * FROM SMS_SiteControlItem WHERE Sitecode="ABC"

Requêtes de prototypes

Le 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 pour ce type de requête. Dans la plupart des cas, une requête prototype renvoie un objet de classe contenant 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 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 de 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 mise à disposition via le pointeur IWbemContext de la IWbemServices::ExecQuery méthode vers le nom de la collection.

Spécifiez une opération JOIN interne en utilisant les classes dérivées dans SMS_CollectionMemberla requête qui est passée à ExecQuery.

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

Voir aussi

Configuration Manager classes d’associationConfiguration Manager propriétés de champ de bitsConfiguration Manager formats de date et d’heure Configuration ManagerobjetsincorporésConfiguration Manager Extended WMI Query LanguagePrésentation des objetsConfigurationManager Lazy PropertiesÀ propos des erreursSécuritédes objets du Configuration Manager