Como executar uma consulta síncrona do Configuration Manager usando código gerenciado

Para executar uma consulta síncrona usando o provedor de SMS gerenciado, use o método WqlConnectionManager.QueryProcessor.ExecuteQuery .

O método ExecuteQuery usa uma cadeia de caracteres de consulta WQL e informações de contexto opcionais para a chamada. Um IResultObject é retornado contendo os objetos encontrados na consulta.

Para executar uma consulta síncrona

  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 WqlConnectionManager obtido na etapa um, chame o método ExecuteQuery do objeto QueryProcessor para consultar o provedor SMS e obter um IResultObject contendo uma coleção de resultados de consulta.

Exemplo

O exemplo de código a seguir mostra como fazer uma consulta síncrona para os pacotes disponíveis usando ExecuteQuery.

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

public void QueryPackages(WqlConnectionManager connection)
{
    try
    {
        IResultObject query = connection.QueryProcessor.ExecuteQuery("Select * from SMS_Package");
        foreach (IResultObject o in query)
        {
            Console.WriteLine(o["Name"].StringValue);
            o.Dispose();
        }
    }
    catch (SmsException ex)
    {
        Console.WriteLine("Failed to query packages: " + 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 Configuration Manager que podem ser geradas são SmsConnectionException e SmsQueryException. Eles podem ser capturados junto com SmsException.

Confira também

Visão geral de objetosConfiguration Manager Propriedades preguiçosasComo chamar um método de classe de objeto do Configuration Manager usando código gerenciadoComo se conectar a um provedor do Configuration Manager usando código gerenciadoComo criar um Objeto do Configuration Manager usando código gerenciadoComo modificar um objeto do Configuration Manager usando código gerenciadoComo executar uma consulta assíncrona do Configuration Manager usando código gerenciadoComo ler um Configuration Manager objeto usando código gerenciadoComo ler propriedades preguiçosas usando código gerenciadoConfigurationManager Extended WMI Query LanguageConfigurationManager Conjuntos de ResultadosConfiguration Manager Consultas EspeciaisSobre consultas