Cómo modificar un objeto Configuration Manager mediante código administrado

Para modificar una instancia de objeto Configuration Manager mediante el proveedor de SMS administrado, use la interfaz IResultObject del objeto para realizar modificaciones. A continuación, llame al método IResultObject.Put para enviar los cambios.

Nota:

La interfaz IResultObject de un objeto se puede obtener mediante el método WqlConnectionManager.GetInstance o a través de otras consultas. Para obtener un ejemplo que usa consultas asincrónicas, vea Cómo realizar una consulta asincrónica Configuration Manager mediante código administrado.

Para modificar un objeto Configuration Manager

1. Configure una conexión con el proveedor de SMS. Para obtener más información, vea Cómo conectarse a un proveedor de SMS en Configuration Manager mediante código administrado.

2. Con el objeto WqlConnectionManager que se obtiene en el paso uno, llame a GetInstance para obtener un objeto IResultObject para el objeto requerido.

3. Realice cambios en el objeto mediante IResultObject.

4. Confirme los cambios en el proveedor de SMS con el método Put del objeto IResultObject.

Ejemplo

La función de ejemplo siguiente actualiza la descripción de un paquete a partir de un identificador de paquete y una descripción proporcionados.

Para obtener información sobre cómo llamar al código de ejemplo, vea Llamar a fragmentos de código de 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;  
    }  
}  

Este método de ejemplo tiene los parámetros siguientes:

Parámetro	Tipo	Descripción
connection	WqlConnectionManager	Una conexión válida al proveedor de SMS.

Compilar el código

Espacios de nombres

System

System.Collections.Generic

System.ComponentModel

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Ensamblado

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programación sólida

Las excepciones Configuration Manager que se pueden generar son SmsConnectionException y SmsQueryException. Estos se pueden detectar junto con SmsException.

Consulta también

Introducción a los objetosConfiguration Manager Propiedades diferidas
Cómo llamar a un método de clase de objeto Configuration Manager mediante código administrado
Conexión a un proveedor de Configuration Manager mediante código administrado
Creación de un objeto Configuration Manager mediante código administrado
Cómo realizar una consulta de Configuration Manager asincrónica mediante código administrado
Cómo realizar una consulta de Configuration Manager sincrónica mediante código administrado
Cómo leer un objeto Configuration Manager mediante código administrado
Cómo leer propiedades diferidas mediante código administrado