Définir une requête WMI

Dans le cadre de la création ou de la modification d'un modèle de détection, vous pouvez utiliser l'opération Requête WMI pour exécuter une requête sur un système Windows distant, explicitement ou automatiquement. Les valeurs obtenues en cas de réussite sont journalisées dans une table cible spécifiée.

Avant de commencer

Rôle requis : pd_admin

Accédez à l'étape de modèle pertinente :

1. Sur le formulaire de modèle, sélectionnez la section d'identification pertinente pour Détection.

   Vous pouvez également sélectionner la section d'identification ou de connexion pertinente pour Mappage des services.

2. Sélectionnez l'étape de modèle pertinente ou cliquez sur le bouton pour ajouter une étape.

Une connaissance de base de la programmation est souhaitée.

Pourquoi et quand exécuter cette tâche

Cette opération n'est pertinente que pour Windows.

Procédure

1. Sélectionnez Requête WMI dans la liste Opération.
2. Définissez le chemin d'accès de l'espace de noms dans le champ Espace de noms.
3. Si vous travaillez avec le mode Déboguer :
   1. Cliquez sur Accélérateur d'instruction pour renseigner automatiquement les valeurs de table et de champ.
   2. Sélectionnez une table dans le volet Nom de la table.
      Les valeurs de champ sont affichées dans le volet Champs.
   3. Définissez les paramètres et les opérateurs pour la condition dans Ajouter une clause de condition.
      Le texte réel de la requête s'affiche dans Obtenir une instruction complète.
4. Si vous ne travaillez pas avec le mode Déboguer, saisissez la chaîne de requête WMI dans Obtenir une instruction complète.
5. Entrez la variable pour la table dans laquelle les données récupérées sont enregistrées dans le champ Ajouter une table cible.
   Vous pouvez entrer une valeur à partir du champ spécifique d'une table, comme décrit dans Saisir des valeurs et des variables dans les modèles.
6. Sélectionnez Utiliser le cache pour enregistrer les résultats de l'opération dans le Serveur MID.
   Utilisez le cache pour optimiser la détection et éviter de créer une charge inutile sur les composants partagés centraux, tels que les équilibreurs de charge. Le système de base conserve les résultats de l'opération en cache pendant une heure.
7. Sélectionnez Terminer pour arrêter la détection si aucun résultat n'est trouvé.
8. Si vous êtes en mode de débogage, testez l'étape en cliquant sur Test et en vérifiant que l'opération renvoie le résultat attendu.

Exemple

Cette opération est utilisée dans	Cet élément
Hiérarchie	Applications > Services de répertoire
Type de CI	IIFP [cmdb_ci_directory_iifp]
Modèle	Modèle IIFP sur Windows
Section	Étape de connectivité de la forêt d'accueil AD-wmi
Numéro et nom de l'étape	1. Obtenir tous les détails des agents via l'étape WMI

Cette étape utilise l'opération Requête WMI pour extraire des données sur les agents de l'espace de noms MicrosoftIdentityIntegrationAgent et enregistrer ces données dans la table de variables nommée $ManagementAgents.

Figure 1. Formulaire de l'opération Requête WMI

Que faire ensuite

• Continuez à modifier le modèle en ajoutant une nouvelle étape et en définissant son fonctionnement.
• Finalisez le modèle.