Como executar uma consulta de Configuration Manager síncrona 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, confira Os fundamentos do Provedor de SMS.

  2. Usando o objeto WqlConnectionManager obtido na primeira etapa, chame o método ExecuteQuery do objeto QueryProcessor para consultar o Provedor de 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 Configuration Manager Snippets de Código.

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 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 modificar um objeto Configuration Manager usando código gerenciado
Como executar uma consulta de Configuration Manager assíncrona usando código gerenciado
Como ler um objeto Configuration Manager usando código gerenciado
Como ler propriedades preguiçosas usando código gerenciado
Configuration Manager Linguagem de Consulta WMI Estendida
conjuntos de resultados Configuration Manager
Configuration Manager consultas especiais
Sobre consultas