Como criar um objeto Configuration Manager usando código gerenciado

Para criar um objeto Configuration Manager 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 Configuration Manager

1. Configure uma conexão com o Provedor de SMS. Para obter mais informações, confira Os fundamentos do Provedor de SMS.

2. Usando o objeto de conexão WqlConnectionManager obtido na primeira etapa, 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 com o provedor de SMS.

Exemplo

O exemplo a seguir demonstra como criar e, em seguida, preencher um novo pacote de Configuration Manager (SMS_Package).

Para obter informações sobre como chamar o código de exemplo, consulte Chamando Configuration Manager Snippets de Código.

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 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 modificar 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