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

Para modificar una instancia de objeto de 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 puede obtenerse mediante el método WqlConnectionManager.GetInstance o mediante otras consultas. Para obtener un ejemplo que usa consultas asincrónicas, vea Cómo realizar una consulta asincrónica de Configuration Manager mediante código administrado.

Para modificar un objeto de Configuration Manager

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

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

  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 siguiente función de ejemplo actualiza la descripción de un paquete a partir de un identificador y una descripción de paquete proporcionados.

Para obtener información sobre cómo llamar al código de ejemplo, consulte 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 siguientes parámetros:

Parámetro Tipo Descripción
connection WqlConnectionManager Una conexión válida con el 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 Configuration Manager excepciones que se pueden generar son SmsConnectionException y SmsQueryException. Estos se pueden detectar junto con SmsException.

Consulta también

Información general sobre objetos:Configuration Manager Lazy PropertiesCómo llamar a un método de clase de objetos de Configuration Manager mediante código administradoCómo conectarse a un proveedor de Configuration Manager mediante código administradoCómo crear un objeto de Configuration Manager mediante código administradoCómo realizar una consulta asincrónica de Configuration Manager mediante código administradoCómo realizar una consulta sincrónica de Configuration Manager mediante código administradoCómo leer una Objeto de Configuration Manager mediante código administradoCómo leer las propiedades diferidas mediante código administrado