Comment lire un objet Configuration Manager à l’aide de code managé

Pour lire une instance d’objet Configuration Manager à l’aide du fournisseur SMS géré, utilisez WqlConnectionManager.GetInstance. La méthode GetInstance prend une chaîne qui identifie une instance d’objet spécifique et renvoie un objet IResultObject utilisé pour accéder à l’objet.

L’exemple de fonction suivant affiche le nom et la description d’un identificateur de package fourni.

Pour lire un objet Configuration Manager

1. Établissez une connexion au fournisseur SMS. Pour plus d’informations, voir Comment se connecter à un fournisseur SMS dans le Configuration Manager à l’aide du code managé.

2. Appelez la méthode GetInstance de la classe WqlConnectionManager pour obtenir l’objet IResultObject de l’objet souhaité.

3. Affichez les propriétés de l’objet IResultObject.

Exemple

L’exemple de code suivant montre comment lire un objet Configuration Manager.

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

public void DisplayPackageName(WqlConnectionManager connection, string packageID)
{
    try
    {
        // Get the package.
        IResultObject package = connection.GetInstance(@"SMS_Package.PackageID='" + packageID + "'");
        Console.WriteLine("Package Name: " + package["Name"].StringValue);
        Console.WriteLine("Package Description: " + package["Description"].StringValue);
    }
    catch (SmsException ex)
    {
        Console.WriteLine("Failed to get package. Error: " + ex.Message);
        throw;
    }
}

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

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 objets

Propriétés différées de Configuration Manager

Comment appeler une méthode de classe d’objet Configuration Manager à l’aide de code managé

Comment 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 Configuration Manager asynchrone à l’aide de code managé

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

Comment lire les propriétés différées à l’aide de code managé