Lesen eines Configuration Manager-Objekts mithilfe von verwaltetem Code

Artikel
04/04/2023

Um eine Configuration Manager Objektinstanz mithilfe des verwalteten SMS-Anbieters zu lesen, verwenden Sie WqlConnectionManager.GetInstance. Die GetInstance-Methode verwendet eine Zeichenfolge, die eine bestimmte Objektinstanz 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

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.
Rufen Sie die GetInstance-Methode der WqlConnectionManager-Klasse auf, um das IResultObject-Objekt für das gewünschte Objekt abzurufen.
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`	-Verwalteten: `WqlConnectionManager`	– Eine gültige Verbindung mit dem SMS-Anbieter.
`PackageID`	-Verwalteten: `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

Übersicht über Objekte Configuration Manager Verzögerte Eigenschaften
Aufrufen einer Configuration Manager-Objektklassenmethode mithilfe von verwaltetem Code
Herstellen einer Verbindung mit einem Configuration Manager Anbieter mithilfe von verwaltetem Code
Erstellen eines Configuration Manager-Objekts mithilfe von verwaltetem Code
Ändern eines Configuration Manager-Objekts mithilfe von verwaltetem Code
Ausführen einer asynchronen Configuration Manager Abfrage mithilfe von verwaltetem Code
Ausführen einer synchronen Configuration Manager Abfrage mithilfe von verwaltetem Code
Lesen verzögerter Eigenschaften mithilfe von verwaltetem Code

Freigeben über