Como modificar um objeto Configuration Manager usando código gerenciado

Para modificar uma instância de objeto Configuration Manager usando o Provedor de SMS gerenciado, use a interface IResultObject do objeto para fazer modificações. Em seguida, você chama o método IResultObject.Put para enviar as alterações.

Observação

A interface IResultObject para um objeto pode ser obtida por meio do método WqlConnectionManager.GetInstance ou por meio de outras consultas. Para obter um exemplo que usa consultas assíncronas, consulte Como executar uma consulta assíncrona Configuration Manager usando código gerenciado.

Para modificar um objeto Configuration Manager

1. Configure uma conexão com o Provedor de SMS. Para obter mais informações, consulte Como se conectar a um provedor de SMS em Configuration Manager usando código gerenciado.

2. Usando o objeto WqlConnectionManager obtido na primeira etapa, chame GetInstance para obter um IResultObject para o objeto necessário.

3. Faça alterações no objeto usando o IResultObject.

4. Confirme as alterações no provedor de SMS com o método Put do objeto IResultObject.

Exemplo

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

Para obter informações sobre como chamar o código de exemplo, consulte Chamando Configuration Manager Snippets 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:

Parâmetro	Tipo	Descrição
connection	WqlConnectionManager	Uma conexão válida com o provedor de SMS.

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 exceções Configuration Manager que podem ser geradas são SmsConnectionException e SmsQueryException. Elas podem ser capturadas junto com SmsException.

Confira também

Visão geral dos objetosConfiguration Manager Propriedades Preguiçosas
Como chamar um método de classe de objeto Configuration Manager usando código gerenciado
Como se conectar a um provedor de Configuration Manager usando código gerenciado
Como criar um objeto Configuration Manager usando código gerenciado
Como executar uma consulta de Configuration Manager assíncrona usando código gerenciado
Como executar uma consulta de Configuration Manager síncrona usando código gerenciado
Como ler um objeto Configuration Manager usando código gerenciado
Como ler propriedades preguiçosas usando código gerenciado