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

Para ler uma instância de objeto do Gerenciador de Configurações usando o provedor SMS gerenciado, use WqlConnectionManager.GetInstance. O método GetInstance usa uma cadeia de caracteres que identifica uma instância de objeto específica e retorna um objeto IResultObject que é usado para acessar o objeto.

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

Para ler um objeto do Gerenciador de Configurações

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

2. Chame o método GetInstance da classe WqlConnectionManager para obter o objeto IResultObject para o objeto desejado.

3. Exiba as propriedades do IResultObject.

Exemplo

O exemplo de código a seguir mostra como ler um objeto do Gerenciador de Configurações.

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 DisplayPackageName(WqlConnectionManager connection, string packageID)
{
    try
    {
        // Get the package.
        IResultObject package = connection.GetInstance(@"SMS_Package.PackageID='" + packageID + "'");
        Console.WriteLine("Package Name: " + package["Name"].StringValue);
        Console.WriteLine("Package 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:

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 criar um objeto 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 propriedades preguiçosas usando código gerenciado