Como ler um objeto Configuration Manager usando código gerenciado

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

  1. Configure uma conexão com o Provedor de SMS. Para obter mais informações, consulte Como se conectar a um provedor de SMS em Configuration Manager 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 Configuration Manager.

Para obter informações sobre como chamar o código de exemplo, consulte Chamando Configuration Manager Snippets 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 -Gerenciado: WqlConnectionManager - Uma conexão válida com o Provedor de SMS.
PackageID -Gerenciado: String Um identificador de pacote válido. Obtido 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 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 executar uma consulta de Configuration Manager síncrona usando código gerenciado
Como ler propriedades preguiçosas usando código gerenciado