Come leggere un oggetto Configuration Manager usando codice gestito

Per leggere un'istanza di oggetto Configuration Manager 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 Configuration Manager

  1. Configurare una connessione al provider SMS. Per altre informazioni, vedere Come connettersi a un provider SMS in Configuration Manager 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 Configuration Manager.

Per informazioni sulla chiamata del codice di esempio, vedere Chiamata di frammenti di codice Configuration Manager.

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 Configuration Manager che possono essere generate sono SmsConnectionException e SmsQueryException. Questi possono essere intercettati insieme a SmsException.

Vedere anche

Panoramica degli oggettiConfiguration Manager Proprietà lazy
Come chiamare un metodo della classe oggetto Configuration Manager usando codice gestito
Come connettersi a un provider di Configuration Manager usando codice gestito
Come creare un oggetto Configuration Manager usando codice gestito
Come modificare un oggetto Configuration Manager usando codice gestito
Come eseguire una query Configuration Manager asincrona usando codice gestito
Come eseguire una query di Configuration Manager sincrona usando codice gestito
Come leggere le proprietà lazy usando codice gestito