Guide pratique pour créer un objet Configuration Manager à l’aide de code managé

Pour créer un objet Configuration Manager à l’aide du fournisseur SMS managé, utilisez la méthode WqlConnectionManager.CreateInstance. La méthode ConnectionManagerBase.CreateInstance prend le type d’objet requis comme paramètre de chaîne et retourne un objet IResultObject utilisé pour remplir le nouvel objet. La méthode IResultObject.Put doit être appelée pour envoyer l’objet au fournisseur SMS.

Pour créer un objet Configuration Manager

1. Configurez une connexion au fournisseur SMS. Pour plus d’informations, consultez Notions de base du fournisseur SMS.

2. À l’aide de l’objet de connexion WqlConnectionManager que vous obtenez à l’étape 1, appelez [CreateInstance pour créer l’objet WMI requis, et recevez son objet IResultObject instance.

3. Remplissez les propriétés IResultObject .

4. Validez IResultObject sur le fournisseur SMS.

Exemple

L’exemple suivant montre comment créer, puis remplir un package Configuration Manager (SMS_Package).

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

public void CreatePackage(WqlConnectionManager connection)
{
    try
    {
        IResultObject package = connection.CreateInstance("SMS_Package");
        package["Name"].StringValue = "Test Package";
        package["Description"].StringValue = "A test package";
        package["PkgSourcePath"].StringValue = @"c:\Package Source";

        package.Put();
    }

    catch (SmsException ex)
    {
        Console.WriteLine("Failed to create 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.

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 de Configuration Manager à l’aide de code managéComment modifier un Configuration Manager objet à l’aide du code managéComment effectuer une requête Configuration Manager asynchrone à l’aide du code managéComment effectuer une requête Configuration Manager synchrone à l’aide du code managéComment lire un objet Configuration Manager objet à l’aide du code managéComment lire des propriétés différées à l’aide de code managé