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 di 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

Namespaces

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à lazy
Come chiamare un metodo della classe oggetto Configuration Manager usando codice gestito
Come connettersi a un provider di Configuration Manager usando codice gestito
Come creare un oggetto Configuration Manager usando codice gestito
Come eseguire una query Configuration Manager asincrona usando codice gestito
Come eseguire una query di Configuration Manager sincrona usando codice gestito
Come leggere un oggetto Configuration Manager usando codice gestito
Come leggere le proprietà lazy usando codice gestito