Come modificare un oggetto di Configuration Manager tramite codice gestito

Per modificare un'istanza dell'oggetto Configuration Manager usando il provider SMS gestito, usare l'interfaccia IResultObject dell'oggetto per apportare modifiche. Quindi, chiamare 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 asincrona di Configuration Manager usando codice gestito.

Per modificare un oggetto di Configuration Manager

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

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

  3. Modificare l'oggetto usando IResultObject.

  4. Eseguire il commit delle modifiche nel 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 di 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 Una connessione valida al provider SMS.

Compilazione del codice

Spazi dei nomi

Sistema

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagementManagementProvider

Microsoft.ConfigurationManagementManagementProvider.WqlQueryEngine

Assembly

Microsoft.ConfigurationManagement.ManagementProvider

adminui.wqlqueryengine

Programmazione efficiente

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

Vedere anche

Panoramica degli oggetti:Proprietà lazy di Configuration ManagerCome chiamare un metodo della classe di oggetti di Configuration Manager tramite codice gestitoCome connettersi a un provider di Configuration Manager tramite codice gestitoCome creare un oggetto di Configuration Manager tramite codice gestitoCome eseguire una query asincrona di Configuration Manager tramite codice gestitoCome eseguire una query di Configuration Manager sincrona usando codice gestitoCome leggere un Oggetto di Configuration Manager tramite codice gestitoCome leggere le proprietà differite tramite codice gestito