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

Pour modifier un objet Configuration Manager instance à l’aide du fournisseur SMS managé, utilisez l’interface IResultObject de l’objet pour apporter des modifications. Vous appelez ensuite la méthode IResultObject.Put pour envoyer les modifications.

Remarque

L’interface IResultObject d’un objet peut être obtenue par le biais de la méthode WqlConnectionManager.GetInstance ou d’autres requêtes. Pour obtenir un exemple qui utilise des requêtes asynchrones, consultez How to Perform an Asynchrone Configuration Manager Query Using Managed Code.

Pour modifier 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. À l’aide de l’objet WqlConnectionManager que vous obtenez à l’étape 1, appelez GetInstance pour obtenir un IResultObject pour l’objet requis.

3. Apportez des modifications à l’objet à l’aide de IResultObject.

4. Validez les modifications apportées au fournisseur SMS avec la méthode Put de l’objet IResultObject.

Exemple

L’exemple de fonction suivant met à jour la description d’un package à partir d’un identificateur et d’une description de package fournis.

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

public void ModifyPackageDescription(WqlConnectionManager connection, string packageID, string description)
{
    try
    {
        IResultObject package = connection.GetInstance(@"SMS_Package.PackageID='" + packageID + "'");
        Console.WriteLine("Package Name: " + package["Name"].StringValue);
        Console.WriteLine("Current Description: " + package["Description"].StringValue);

        package["Description"].StringValue = description;

        package.Put();

        Console.WriteLine("New 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	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 Configuration Manager à l’aide de code managéComment créer 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é