Guide pratique pour lire un objet Configuration Manager à l’aide du code managé

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

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

Pour lire un objet Configuration Manager

1. Configurez une connexion au fournisseur SMS. Pour plus d’informations, consultez Guide pratique pour se connecter à un fournisseur SMS dans Configuration Manager à l’aide de code managé.

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

3. Affiche les propriétés de 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 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 a les paramètres suivants :

Paramètre	Type	Description
Connection	-Géré: WqlConnectionManager	- Connexion valide au fournisseur SMS.
PackageID	-Géré: String	Identificateur de package valide. Obtenu à partir de la propriété PackageID de la classe SMS_Package .

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

Vue d’ensemble des objetsConfiguration Manager Propriétés différéesComment appeler une méthode de classe d’objet Configuration Manager à l’aide de code managéComment se connecter à un fournisseur Configuration Manager à l’aide de code managéComment créer un Configuration Manager objet à l’aide du code managéComment modifier un objet Configuration Manager à l’aide du code managéComment effectuer une requête asynchrone Configuration Manager à l’aide du code managéComment effectuer une requête synchrone Configuration Manager requête à l’aide du code managéGuide pratique pour lire des propriétés différées à l’aide de code managé