Partilhar via


Como ler um objeto de gestor de configuração usando código gerido

Para ler uma instância de objeto do Gestor de Configuração utilizando o fornecedor de SMS gerido, utilize o WqlConnectionManager.GetInstance. O método GetInstance pega numa cadeia que identifica uma instância específica do objeto e devolve um objeto IResultObject que é usado para aceder ao objeto.

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

Para ler um objeto do Gestor de Configuração

  1. Configurar uma ligação com o Fornecedor DE SMS. Para obter mais informações, consulte Como Ligação a um Fornecedor de SMS no Gestor de Configuração utilizando o Código Gerido.

  2. Ligue para o método getInstance da classe WqlConnectionManager para obter o objeto IResultObject para o objeto que deseja.

  3. Exiba as propriedades do IResultObject.

Exemplo

O exemplo de código que se segue mostra como ler um objeto Do Gestor de Configuração.

Para obter informações sobre a chamada do código de amostra, consulte o Código de Identificação do Gestor de Chamadas.

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 Description
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 SMS_Package classe PackageID.

A Compilar o Código

Espaços de nomes

Sistema

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assemblagem

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programação Robusta

As exceções do Gestor de Configuração que podem ser levantadas são SmsConnectionException e SmsQueryException. Estes podem ser apanhados juntamente com o SmsException.

Consulte também

Visão geral de objetos Gestor de Configuração Propriedades Preguiçosas
Como chamar um método de classe de objeto de gestor de configuração usando código gerido
Como Ligação a um fornecedor de gestor de configuração usando código gerido
Como criar um objeto de gestor de configuração usando código gerido
Como modificar um objeto de gestor de configuração utilizando código gerido
Como executar uma consulta de gestor de configuração assíncronea através da utilização de código gerido
Como executar uma consulta de gestor de configuração sincronizada através da utilização de código gerido
Como Ler Propriedades Lentas ao Utilizar o Código Gerido