How to Read a Configuration Manager Object by Using Managed Code (Como Ler um Objeto de Configuration Manager com o Código Gerido)

Para ler uma instância de objeto Configuration Manager 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 Configuration Manager

1. Configure uma ligação ao Fornecedor de SMS. Para obter mais informações, veja How to Connect to an SMS Provider in Configuration Manager by Using Managed Code (Como Ligar a um Fornecedor de SMS no Configuration Manager 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 Configuration Manager.

Para obter informações sobre como chamar o código de exemplo, veja Chamar Configuration Manager 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:

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

Confira também

Descrição geral dos objetosConfiguration Manager Propriedades LentasComo Chamar um Método de Classe de Objeto Configuration Manager através do Código GeridoComo Ligar a um Fornecedor de Configuration Manager através do Código GeridoComo Criar um Configuration Manager Objeto ao Utilizar Código GeridoComo Modificar um Objeto de Configuration Manager Utilizando Código GeridoComo Executar uma Consulta de Configuration Manager Assíncrona com o Código GeridoComo Executar uma Consulta Síncrona Configuration Manager Consulta com o Código GeridoComo Ler Propriedades Lentas Utilizando o Código Gerido