Créer des requêtes dans Configuration Manager

Article
04/04/2023

S’applique à : Gestionnaire de Configuration (branche actuelle)

Cet article explique comment créer et importer des requêtes dans Configuration Manager.

Créer une requête

Utilisez cette procédure pour créer une requête dans Configuration Manager.

Dans la console Configuration Manager, sélectionnez Surveillance.
Dans l’espace de travail Surveillance , sélectionnez Requêtes. Sous l’onglet Accueil , dans le groupe Créer , sélectionnez Créer une requête.
Sous l’onglet Général de l’Assistant Création d’une requête, spécifiez un nom unique et, éventuellement, un commentaire pour la requête.
Si vous souhaitez importer une requête existante à utiliser comme base pour la nouvelle requête, sélectionnez Importer l’instruction de requête. Dans la boîte de dialogue Parcourir la requête , sélectionnez une requête que vous souhaitez importer, puis sélectionnez OK.

Dans la liste Type d’objet , sélectionnez le type d’objet que vous souhaitez que la requête retourne. Ce tableau décrit quelques exemples des types d’objets que vous pouvez rechercher :

Type d’objet	Description
Ressource système	Utilisez pour rechercher des attributs système classiques, tels que le nom NetBIOS d’un appareil, la version du client, l’adresse IP du client et les informations services de domaine Active Directory.
Ressource utilisateur	Permet de rechercher des informations utilisateur classiques, telles que les noms d’utilisateurs, les noms de groupes d’utilisateurs et les noms de groupes de sécurité.
Déploiement	Utilisez pour rechercher les attributs classiques d’un déploiement, comme le nom du déploiement, la planification et la collection sur laquelle il a été déployé.

Sélectionnez Modifier l’instruction de requête pour ouvrir la boîte de dialoguePropriétés de l’instruction<de nom> de requête.
Sous l’onglet Général de la boîte de dialoguePropriétés de l’instruction<de nom> de requête, spécifiez les attributs que la requête retourne et la façon dont ils doivent être affichés. Sélectionnez l’icône Nouveau pour ajouter un nouvel attribut. Vous pouvez également sélectionner Afficher le langage de requête pour entrer ou modifier la requête directement dans le langage de requête WQL (WQL). Pour obtenir des exemples de requêtes WMI, consultez la section Exemples de requêtes WQL de cet article.
- Vous pouvez utiliser la documentation de référence suivante pour vous aider à créer vos propres requêtes WQL :
- À compter de Configuration Manager 2010, vous pouvez afficher un aperçu des résultats lorsque vous créez ou modifiez une requête pour l’appartenance à une collection. Dans propriétés de l’instruction de requête, sélectionnez le triangle vert pour afficher la fenêtre Aperçu des résultats de la requête . Sélectionnez Arrêter si vous souhaitez arrêter une requête de longue durée.
Sous l’onglet Critères de la boîte de dialoguePropriétés de l’instruction<de nom> de requête, spécifiez les critères utilisés pour affiner les résultats de la requête. Par exemple, vous pouvez retourner uniquement les ressources dont le code de site est XYZ. Vous pouvez configurer plusieurs critères pour une requête.

Importante

Si vous créez une requête qui ne contient aucun critère, la requête retourne tous les appareils dans le regroupement Tous les systèmes .

Sous l’onglet Jointures de la boîte de dialoguePropriétés de l’instruction<de nom> de requête, vous pouvez combiner des données de deux attributs différents dans les résultats de votre requête. Bien que Configuration Manager crée automatiquement des jointures de requête lorsque vous choisissez des attributs différents pour le résultat de votre requête, l’onglet Jointures fournit des options plus avancées. Configuration Manager prend en charge les classes d’attribut suivantes :

Type de jointure	Description
Intérieur	Affiche uniquement les résultats correspondants. Toujours utilisé par les jointures créées automatiquement.
Gauche	Affiche tous les résultats de l’attribut de base et uniquement les résultats correspondants pour l’attribut de jointure.
Droite	Affiche tous les résultats de l’attribut de jointure et uniquement les résultats correspondants pour l’attribut de base.
Complet	Affiche tous les résultats pour l’attribut de base et l’attribut de jointure.

Pour plus d’informations sur l’utilisation des opérations de jointure, consultez la documentation SQL Server.

Sélectionnez OK pour fermer la boîte de dialoguePropriétés de l’instruction<de nom> de requête.
Sous l’onglet Général de l’Assistant Création d’une requête, spécifiez que les résultats de la requête ne sont pas limités aux membres d’une collection, qu’ils sont limités aux membres d’une collection spécifiée ou qu’une invite pour une collection s’affiche chaque fois que la requête est exécutée.
Terminez l’Assistant pour créer la requête. La nouvelle requête apparaît dans le nœud Requêtes de l’espace de travail Surveillance .

Importer une requête

Utilisez cette procédure pour importer une requête dans Configuration Manager. Pour plus d’informations sur l’exportation de requêtes, consultez Guide pratique pour gérer les requêtes.

Dans la console Configuration Manager, sélectionnez Surveillance.
Dans l’espace de travail Surveillance , sélectionnez Requêtes. Sous l’onglet Accueil , dans le groupe Créer , sélectionnez Importer des objets.
Dans la page Nom de fichier MOF de l’Assistant Importation d’objets, sélectionnez Parcourir pour sélectionner le fichier MOF (Managed Object Format) qui contient la requête que vous souhaitez importer.
Passez en revue les informations sur la requête à importer, puis terminez l’Assistant. La nouvelle requête s’affiche sur le nœud Requêtes dans l’espace de travail Surveillance .

Exemples de requêtes WQL

Cette section contient des exemples de requêtes WQL que vous pouvez utiliser dans votre hiérarchie ou modifier à d’autres fins. Pour utiliser ces requêtes, sélectionnez Afficher le langage de requête dans la boîte de dialogue Propriétés de l’instruction de requête. Ensuite, copiez et collez la requête dans le champ Instruction de requête .

Conseil

Utilisez le caractère % générique pour indiquer toute chaîne de caractères. Par exemple, %Visio% retourne Microsoft Office Visio 2010.

Ordinateurs qui exécutent Windows 10

Utilisez la requête suivante pour retourner le nom NetBIOS et la version du système d’exploitation de tous les ordinateurs qui exécutent Windows 10.

select SMS_R_System.NetbiosName,  
SMS_R_System.OperatingSystemNameandVersion from
SMS_R_System where
SMS_R_System.OperatingSystemNameandVersion like "%Workstation 10%"

Ordinateurs sur lesquels un package logiciel spécifique est installé

Utilisez la requête suivante pour renvoyer le nom NetBIOS et le nom du package logiciel de tous les ordinateurs sur lesquels un package logiciel spécifique est installé. Cet exemple retourne tous les ordinateurs sur lesquels une version de Microsoft Visio est installée. Remplacez par Microsoft%Visio% le package logiciel que vous souhaitez interroger.

Conseil

Cette requête recherche le package logiciel à l’aide des noms affichés dans la liste des programmes dans Windows Panneau de configuration.

select SMS_R_System.NetbiosName,
SMS_G_System_ADD_REMOVE_PROGRAMS.DisplayName from
SMS_R_System inner join SMS_G_System_ADD_REMOVE_PROGRAMS on
SMS_G_System_ADD_REMOVE_PROGRAMS.ResourceId =
SMS_R_System.ResourceId where
SMS_G_System_ADD_REMOVE_PROGRAMS.DisplayName like "Microsoft%Visio%"

Ordinateurs d’une unité d’organisation services de domaine Active Directory spécifique

Utilisez la requête suivante pour retourner le nom NetBIOS et le nom de l’unité d’organisation (UO) de tous les ordinateurs d’une unité d’organisation spécifiée. Remplacez le texte OU Name par le nom de l’unité d’organisation que vous souhaitez interroger.

select SMS_R_System.NetbiosName,
SMS_R_System.SystemOUName from
SMS_R_System where
SMS_R_System.SystemOUName = "OU Name"

Ordinateurs avec un nom NetBIOS spécifique

Utilisez la requête suivante pour retourner le nom NetBIOS de tous les ordinateurs qui commencent par une chaîne de caractères spécifique. Dans cet exemple, la requête retourne tous les ordinateurs dont le nom NetBIOS commence par ABC.

select SMS_R_System.NetbiosName from
SMS_R_System where SMS_R_System.NetbiosName like "ABC%"

Appareils d’un type spécifique

Les types d’appareils sont stockés dans la base de données Configuration Manager sous la classe de ressources sms_r_system et le nom d’attribut AgentEdition. Utilisez cette requête pour récupérer uniquement les appareils qui correspondent à l’édition de l’agent du type d’appareil que vous spécifiez :

Select SMS_R_System.ClientEdition from SMS_R_System where SMS_R_System.ClientEdition = <Device ID>

Utilisez l’une de ces valeurs pour ID d’appareil <>:

Type d’appareil	Valeur de AgentEdition
Ordinateur de bureau ou ordinateur portable Windows	0
Appareil Windows ARM (exécutant Windows RT)	1
Windows Mobile 6.5	2
Nokia Symbian	3
Windows Phone	4
Ordinateur Mac	5
Windows Embedded	7
Système Intel sur une puce	12
Microsoft HoloLens (GPM)	15
Microsoft Surface Hub (GPM)	16

Remarque

Les valeurs qui ne sont pas répertoriées dans ce tableau sont associées à des appareils qui ne sont plus pris en charge.

Par exemple, si vous souhaitez retourner uniquement des ordinateurs Mac, utilisez cette requête :

Select SMS_R_System.ClientEdition from SMS_R_System where SMS_R_System.ClientEdition = 5

Appareils cogérés

select SMS_R_SYSTEM.ResourceID, SMS_R_SYSTEM.ResourceType, SMS_R_SYSTEM.Name,
SMS_R_SYSTEM.SMSUniqueIdentifier, SMS_R_SYSTEM.ResourceDomainORWorkgroup, SMS_R_SYSTEM.Client
from SMS_R_System
inner join SMS_Client_ComanagementState on SMS_Client_ComanagementState.ResourceId = SMS_R_System.ResourceId 
where SMS_Client_ComanagementState.ComgmtPolicyPresent = 1 AND SMS_Client_ComanagementState.MDMEnrolled = 1 AND MDMProvisioned = 1

Prochaines étapes

Comment gérer les requêtes