Como criar um objeto do Gerenciador de Configurações usando código gerenciado

Para criar um objeto do Gerenciador de Configurações usando o provedor de SMS gerenciado, use o método WqlConnectionManager.CreateInstance. O método ConnectionManagerBase.CreateInstance usa o tipo de objeto necessário como um parâmetro de cadeia de caracteres e retorna um objeto IResultObject que é usado para preencher o novo objeto. O método IResultObject.Put deve ser chamado para enviar o objeto ao provedor de SMS.

Para criar um objeto do Gerenciador de Configurações

  1. Configure uma conexão com o provedor de SMS. Para obter mais informações, consulte Conceitos básicos do Provedor SMS.

  2. Usando o objeto de conexão WqlConnectionManager obtido na etapa um, chame [CreateInstance para criar o objeto WMI necessário e receba sua instância de objeto IResultObject.

  3. Preencha as propriedades IResultObject .

  4. Confirme o IResultObject para o provedor SMS.

Exemplo

O exemplo a seguir demonstra como criar e preencher um novo pacote do Gerenciador de Configurações (SMS_Package).

Para obter informações sobre como chamar o código de exemplo, consulte Chamando trechos de código do Gerenciador de Configurações.

public void CreatePackage(WqlConnectionManager connection)
{
    try
    {
        IResultObject package = connection.CreateInstance("SMS_Package");
        package["Name"].StringValue = "Test Package";
        package["Description"].StringValue = "A test package";
        package["PkgSourcePath"].StringValue = @"c:\Package Source";

        package.Put();
    }

    catch (SmsException ex)
    {
        Console.WriteLine("Failed to create package. Error: " + ex.Message);
        throw;
    }
}

Este método de exemplo tem os seguintes parâmetros:

Parâmetro Tipo Descrição
connection Gerenciado: 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 do Gerenciador de Configurações que podem ser geradas são SmsConnectionException e SmsQueryException. Eles podem ser capturados junto com SmsException.

Confira também

Visão geral de objetos

Propriedades preguiçosas do Gerenciador de Configurações

Como chamar um método de classe de objeto do Gerenciador de Configurações usando código gerenciado

Como se conectar a um provedor do Gerenciador de Configurações usando código gerenciado

Como modificar um objeto do Gerenciador de Configurações usando código gerenciado

Como executar uma consulta assíncrona do Gerenciador de Configurações usando código gerenciado

Como executar uma consulta síncrona do Gerenciador de Configurações usando código gerenciado

Como ler um objeto do Gerenciador de Configurações usando código gerenciado

Como ler propriedades preguiçosas usando código gerenciado