Comment effectuer une requête de Configuration Manager synchrone à l’aide de code managé

2025-06-06

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

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

Pour effectuer une requête synchrone

Configurez une connexion au fournisseur SMS. Pour plus d’informations, consultez Notions de base du fournisseur SMS.
À l’aide de l’objet WqlConnectionManager que vous obtenez à l’étape 1, appelez la méthode ExecuteQuery de l’objet QueryProcessor pour interroger le fournisseur SMS et obtenez 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 de ExecuteQuery.

Pour plus d’informations sur l’appel de l’exemple de code, consultez Appel d’extraits de code 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 a 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 Configuration Manager qui peuvent être levées sont SmsConnectionException et SmsQueryException. Ceux-ci peuvent être regroupés avec SmsException.

Voir aussi

Partager via