Come leggere un oggetto Gestione configurazione usando codice gestito

Per leggere un'istanza di oggetto Gestione configurazione usando il provider SMS gestito, usare WqlConnectionManager.GetInstance. Il metodo GetInstance accetta una stringa che identifica un'istanza di oggetto specifica e restituisce un oggetto IResultObject 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 Gestione configurazione

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

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

  3. Visualizzare le proprietà dell'oggetto IResultObject.

Esempio

Nell'esempio di codice seguente viene illustrato come leggere un oggetto Gestione configurazione.

Per informazioni sulla chiamata del codice di esempio, vedere Chiamata di frammenti di codice 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 Connessione valida al provider SMS.
PackageID Gestito: String Identificatore di pacchetto valido. Ottenuto dalla proprietà PackageID della classe SMS_Package .

Compilazione del codice

Namespaces

Sistema

System.collections.generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Programmazione efficiente

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

Vedere anche

Panoramica sugli oggetti

proprietà lazy Gestione configurazione

Come chiamare un metodo della classe oggetto Gestione configurazione usando codice gestito

Come connettersi a un provider di Gestione configurazione usando codice gestito

Come creare un oggetto Gestione configurazione usando codice gestito

Come modificare un oggetto Gestione configurazione usando codice gestito

Come eseguire una query Gestione configurazione asincrona usando codice gestito

Come eseguire una query di Gestione configurazione sincrona usando codice gestito

Come leggere le proprietà lazy usando codice gestito