Come modificare un oggetto Configuration Manager usando codice gestito

Per modificare un'istanza di oggetto Configuration Manager usando il provider SMS gestito, usare l'interfaccia IResultObject dell'oggetto per apportare modifiche. Chiamare quindi il metodo IResultObject.Put per inviare le modifiche.

Nota

L'interfaccia IResultObject per un oggetto può essere ottenuta tramite il metodo WqlConnectionManager.GetInstance o tramite altre query. Per un esempio che usa query asincrone, vedere Come eseguire una query Configuration Manager asincrona usando codice gestito.

Per modificare un oggetto Configuration Manager

1. Configurare una connessione al provider SMS. Per altre informazioni, vedere Come connettersi a un provider SMS in Configuration Manager tramite codice gestito.

2. Usando l'oggetto WqlConnectionManager ottenuto nel passaggio 1, chiamare GetInstance per ottenere un IResultObject per l'oggetto richiesto.

3. Apportare modifiche all'oggetto usando IResultObject.

4. Eseguire il commit delle modifiche apportate al provider SMS con il metodo Put dell'oggetto IResultObject.

Esempio

La funzione di esempio seguente aggiorna la descrizione di un pacchetto da un identificatore e una descrizione del pacchetto forniti.

Per informazioni sulla chiamata del codice di esempio, vedere Chiamata di frammenti di codice 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;
    }
}

Questo metodo di esempio include i parametri seguenti:

Parametro	Tipo	Descrizione
connection	WqlConnectionManager	Connessione valida al provider SMS.

Compilazione del codice

Spazi dei nomi

Sistema

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programmazione efficiente

Le eccezioni Configuration Manager che possono essere generate sono SmsConnectionException e SmsQueryException. Questi possono essere intercettati insieme a SmsException.

Vedere anche

Panoramica degli oggettiConfiguration Manager Proprietà lazyCome chiamare un metodo della classe oggetto Configuration Manager tramite codice gestitoCome connettersi a un provider di Configuration Manager usando codice gestitoCome creare un oggetto Configuration Manager oggetto tramite codice gestitoCome eseguire una query di Configuration Manager asincrona usando codice gestitoCome eseguire una query di Configuration Manager sincrona usando codice gestitoCome leggere un oggetto Configuration Manager object by Using Managed CodeHow to Read Lazy Properties by Using Managed Code