How to Read a Gerenciador de Configurações Object by Using Managed Code (Como Ler um Objeto de Gerenciador de Configurações com o Código Gerido)

Para ler uma instância de objeto Gerenciador de Configurações com o Fornecedor de SMS gerido, utilize WqlConnectionManager.GetInstance. O método GetInstance utiliza uma cadeia que identifica uma instância de objeto específica e devolve um objeto IResultObject que é utilizado para aceder ao objeto.

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

Para ler um objeto Gerenciador de Configurações

  1. Configure uma ligação ao Fornecedor de SMS. Para obter mais informações, veja How to Connect to an SMS Provider in Gerenciador de Configurações by Using Managed Code (Como Ligar a um Fornecedor de SMS no Gerenciador de Configurações Através do Código Gerido).

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

  3. Apresentar as propriedades do IResultObject.

Exemplo

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

Para obter informações sobre como chamar o código de exemplo, veja Chamar Gerenciador de Configurações Fragmentos de Código.

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:

Parâmetro Tipo Descrição
Connection Gerido: WqlConnectionManager Uma ligação válida ao Fornecedor de SMS.
PackageID Gerido: String Um identificador de pacote válido. Obtido a partir da propriedade PackageID da classe SMS_Package .

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 Gerenciador de Configurações exceções que podem ser geradas são SmsConnectionException e SmsQueryException. Estes podem ser capturados em conjunto com SmsException.

Confira também

Visão geral de objetos

Gerenciador de Configurações Propriedades Lentas

How to Call a Gerenciador de Configurações Object Class Method by Using Managed Code (Como Chamar um Método de Classe de Objeto Gerenciador de Configurações com o Código Gerido)

Como Ligar a um Fornecedor de Gerenciador de Configurações com o Código Gerido

Como Criar um objeto de Gerenciador de Configurações com o Código Gerido

How to Modify a Gerenciador de Configurações Object by Using Managed Code (Como Modificar um Objeto de Gerenciador de Configurações com o Código Gerido)

Como Executar uma Consulta de Gerenciador de Configurações Assíncrona com o Código Gerido

Como Executar uma Consulta de Gerenciador de Configurações Síncrona com o Código Gerido

How to Read Lazy Properties by Using Managed Code