Lesen eines Configuration Manager-Objekts mithilfe von verwaltetem Code

Verwenden Sie WqlConnectionManager.GetInstance, um ein Configuration 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 Configuration 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 Configuration 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 Configuration Manager -Objekt gelesen wird.

Informationen zum Aufrufen des Beispielcodes finden Sie unter Aufrufen von Configuration 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:

Parameter	Typ	Beschreibung
Connection	-Gehandhabt: WqlConnectionManager	– Eine gültige Verbindung mit dem SMS-Anbieter.
PackageID	-Gehandhabt: String	Ein gültiger Paketbezeichner. Wird von der SMS_Package Klasse PackageID-Eigenschaft abgerufen.

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 Configuration Manager Ausnahmen, die ausgelöst werden können, sind SmsConnectionException und SmsQueryException. Diese können zusammen mit SmsException abgefangen werden.

Siehe auch

ObjektübersichtConfiguration Manager Verzögerte EigenschaftenAufrufen einer Configuration Manager Objektklassenmethode mithilfe von verwaltetem CodeHerstellen einer Verbindung mit einem Configuration Manager Anbieter mithilfe von verwaltetem CodeVorgehensweise: Erstellen einer Configuration Manager-Objekts mithilfe von verwaltetem CodeÄndern eines Configuration Manager-Objekts mithilfe von verwaltetem CodeAusführen einer asynchronen Configuration Manager Abfrage mithilfe von verwaltetem CodeVorgehensweise: Ausführen eines synchronen Objekts Configuration Manager Abfragen mithilfe von verwaltetem CodeLesen verzögerter Eigenschaften mithilfe von verwaltetem Code