Procédure pour exécuter une requête Configuration Manager synchrone à l’aide de code managé

Pour effectuer une requête synchrone à l’aide du fournisseur SMS géré, vous utilisez la méthode WqlConnectionManager.QueryProcessor.ExecuteQuery .

La méthode ExecuteQuery prend une chaîne de requête WQL et des informations de contexte facultatives pour l’appel. Un IResultObject contenant les objets trouvés dans la requête est renvoyé.

Pour exécuter une requête synchrone

  1. Établissez une connexion au fournisseur SMS. Pour plus d’informations, consultez Principes de base du fournisseur SMS.

  2. À l’aide de l’objet WqlConnectionManager obtenu à la première étape, appelez l’objet QueryProcessor méthode ExecuteQuery pour interroger le fournisseur SMS et obtenir un IResultObject contenant une collection de résultats de requête.

Exemple

L’exemple de code suivant montre comment effectuer une requête synchrone pour les packages disponibles à l’aide d’ExecuteQuery.

Pour plus d’informations sur l’appel de l’exemple de code, consultez Appel d’extraits de code de Configuration Manager.

public void QueryPackages(WqlConnectionManager connection)
{
    try
    {
        IResultObject query = connection.QueryProcessor.ExecuteQuery("Select * from SMS_Package");
        foreach (IResultObject o in query)
        {
            Console.WriteLine(o["Name"].StringValue);
            o.Dispose();
        }
    }
    catch (SmsException ex)
    {
        Console.WriteLine("Failed to query packages: " + ex.Message);
        throw;
    }
}

Cet exemple de méthode contient les paramètres suivants :

Paramètre Type Description
connection Géré : WqlConnectionManager Connexion valide au fournisseur SMS.

Compilation du code

Espaces de noms

Système

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

Microsoft.ConfigurationManagement.ManagementProvider

adminui.wqlqueryengine

Programmation robuste

Les exceptions du Configuration Manager qui peuvent être levées sont SmsConnectionException et SmsQueryException. Ceux-ci peuvent être interceptés avec SmsException.

Voir aussi

Vue d’ensemble des objetsPropriétés différées de Configuration ManagerConfiguration ManagerComment appeler une méthode de classe d’objet Configuration Manager à l’aide de code managéProcédure pour se connecter à un fournisseur de Configuration Manager à l’aide de code managéComment créer un Objet Configuration Manager à l’aide de code managéComment modifier un objet Configuration Manager à l’aide de code managéProcédure pour exécuter une requête asynchrone du Configuration Manager à l’aide de code managéProcédure pour lire un Configuration Manager Object by using Managed CodeComment lire les propriétés différées à l’aide de code managéConfiguration Manager langage de requête WMI étenduConfiguration Manager jeux de résultatsConfiguration Manager requêtes spécialessur les requêtes