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

Spazi dei nomi

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à lazyCome chiamare un metodo della classe oggetto Configuration Manager tramite codice gestitoCome connettersi a un provider di Configuration Manager usando codice gestitoCome creare un oggetto Configuration Manager object by Using Managed CodeHow to Modify a Configuration Manager Object by Using Managed CodeHow to Perform an Asynchronous Configuration Manager Query by Using Managed CodeHow to Perform a Synchronous Configuration Manager query tramite codice gestitoCome leggere le proprietà lazy usando codice gestito