How to Modify a Configuration Manager Object by Using Managed Code (Como Modificar um Objeto de Configuration Manager com o Código Gerido)

Para modificar uma instância de objeto Configuration Manager com o Fornecedor de SMS gerido, utilize a interface IResultObject do objeto para efetuar modificações. Em seguida, chama o método IResultObject.Put para submeter as alterações.

Para modificar um objeto de Configuration Manager

1. Configure uma ligação ao Fornecedor de SMS. Para obter mais informações, veja How to Connect to an SMS Provider in Configuration Manager by Using Managed Code (Como Ligar a um Fornecedor de SMS no Configuration Manager Através do Código Gerido).

2. Com o objeto WqlConnectionManager que obtém no primeiro passo, chame GetInstance para obter um IResultObject para o objeto necessário.

3. Faça alterações ao objeto com o IResultObject.

4. Consolide as alterações ao fornecedor de SMS com o método Put do objeto IResultObject.

Exemplo

A função de exemplo seguinte atualiza a descrição de um pacote a partir de um identificador de pacote fornecido e descrição.

Para obter informações sobre como chamar o código de exemplo, veja Chamar Configuration Manager Fragmentos de Código.

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 exemplo tem os seguintes parâmetros:

Compilando o código

Namespaces

System

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programação robusta

As Configuration Manager exceções que podem ser geradas são SmsConnectionException e SmsQueryException. Estes podem ser capturados em conjunto com SmsException.

Confira também

Descrição geral dos objetosConfiguration Manager Propriedades LentasComo Chamar um Método de Classe de Objeto Configuration Manager através do Código GeridoComo Ligar a um Fornecedor de Configuration Manager através do Código GeridoComo Criar um Configuration Manager Objeto ao Utilizar Código GeridoComo Executar uma Consulta de Configuration Manager Assíncrona com o Código GeridoComo Executar uma Consulta de Configuration Manager Síncrona com o Código GeridoComo Ler uma Configuration Manager Objeto através do Código GeridoComo Ler Propriedades Lentas Utilizando o Código Gerido