Come leggere un oggetto di Gestione configurazione tramite codice gestito

Per leggere un'istanza dell'oggetto Gestione configurazione usando il provider SMS gestito, usare WqlConnectionManager.GetInstance. Il metodo GetInstance accetta una stringa che identifica un'istanza dell'oggetto specifica e restituisce un oggetto IResultObject che viene utilizzato per accedere all'oggetto.

La funzione di esempio seguente mostra il nome e la descrizione di un identificatore di pacchetto fornito.

Per leggere un oggetto di Gestione configurazione

  1. Configurare una connessione al provider SMS. Per altre informazioni, vedere Come connettersi a un provider SMS in Gestione configurazione usando codice gestito.

  2. Chiamare il metodo GetInstance della classe WqlConnectionManager per ottenere l'oggetto IResultObject per l'oggetto desiderato.

  3. Visualizzare le proprietà di IResultObject.

Esempio

L'esempio di codice seguente mostra come leggere un oggetto di Gestione configurazione.

Per informazioni sulla chiamata del codice di esempio, vedere Chiamata di frammenti di codice di Gestione configurazione.

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;
    }
}

Questo metodo di esempio include i parametri seguenti:

Parametro Tipo Descrizione
Connection Gestito: WqlConnectionManager Una connessione valida al provider SMS.
PackageID Gestito: String Identificatore del pacchetto valido. Ottenuto dalla proprietà PackageID della classe SMS_Package .

Compilazione del codice

Spazi dei nomi

Sistema

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagementManagementProvider

Microsoft.ConfigurationManagementManagementProvider.WqlQueryEngine

Assembly

Microsoft.ConfigurationManagement.ManagementProvider

adminui.wqlqueryengine

Programmazione efficiente

Le eccezioni di Gestione configurazione che possono essere generate sono SmsConnectionException e SmsQueryException. Questi possono essere intercettati insieme a SmsException.

Vedere anche

Panoramica sugli oggetti

Gestione configurazione proprietà pigre

Come chiamare un metodo della classe di oggetti di Gestione configurazione tramite codice gestito

Come connettersi a un provider di Gestione configurazione tramite codice gestito

Come creare un oggetto di Gestione configurazione tramite codice gestito

Come modificare un oggetto di Gestione configurazione tramite codice gestito

Come eseguire una query asincrona di Gestione configurazione tramite codice gestito

Come eseguire una query sincrona di Gestione configurazione tramite codice gestito

Come leggere le proprietà differite tramite codice gestito