Lesen eines Konfigurations-Manager-Objekts mithilfe von verwaltetem Code

Verwenden Sie WqlConnectionManager.GetInstance, um ein Konfigurations-Manager-Objekt zu lesen, das mithilfe des verwalteten SMS-Anbieters instance. Die GetInstance-Methode verwendet eine Zeichenfolge, die ein bestimmtes Objekt instance identifiziert, und gibt ein IResultObject-Objekt zurück, das für den Zugriff auf das Objekt verwendet wird.

Die folgende Beispielfunktion zeigt den Namen und die Beschreibung für einen angegebenen Paketbezeichner.

So lesen Sie ein Konfigurations-Manager-Objekt

1. Richten Sie eine Verbindung mit dem SMS-Anbieter ein. Weitere Informationen finden Sie unter Herstellen einer Verbindung mit einem SMS-Anbieter in Konfigurations-Manager mithilfe von verwaltetem Code.

2. Rufen Sie die GetInstance-Methode der WqlConnectionManager-Klasse auf, um das IResultObject-Objekt für das gewünschte Objekt abzurufen.

3. Zeigt die Eigenschaften des IResultObject an.

Beispiel

Im folgenden Codebeispiel wird gezeigt, wie ein Konfigurations-Manager -Objekt gelesen wird.

Informationen zum Aufrufen des Beispielcodes finden Sie unter Aufrufen von Konfigurations-Manager Codeausschnitten.

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

Diese Beispielmethode weist die folgenden Parameter auf:

Kompilieren des Codes

Namespaces

System

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Robuste Programmierung

Die Konfigurations-Manager Ausnahmen, die ausgelöst werden können, sind SmsConnectionException und SmsQueryException. Diese können zusammen mit SmsException abgefangen werden.

Siehe auch

Übersicht über Objekte

Konfigurations-Manager Verzögerte Eigenschaften

Aufrufen einer Konfigurations-Manager-Objektklassenmethode mithilfe von verwaltetem Code

Herstellen einer Verbindung mit einem Konfigurations-Manager Anbieter mithilfe von verwaltetem Code

Erstellen eines Konfigurations-Manager-Objekts mithilfe von verwaltetem Code

Ändern eines Konfigurations-Manager-Objekts mithilfe von verwaltetem Code

Ausführen einer asynchronen Konfigurations-Manager Abfrage mithilfe von verwaltetem Code

Ausführen einer synchronen Konfigurations-Manager Abfrage mithilfe von verwaltetem Code

Lesen verzögerter Eigenschaften mithilfe von verwaltetem Code