Share via


Een Configuration Manager-object lezen met behulp van beheerde code

Als u een Configuration Manager-objectexemplaar wilt lezen met behulp van de beheerde SMS-provider, gebruikt u WqlConnectionManager.GetInstance. Met de methode GetInstance wordt een tekenreeks gebruikt die een specifiek objectexemplaar identificeert en een IResultObject-object retourneert dat wordt gebruikt voor toegang tot het object.

In de volgende voorbeeldfunctie ziet u de naam en beschrijving voor een opgegeven pakket-id.

Een Configuration Manager-object lezen

  1. Een verbinding met de SMS-provider instellen. Zie Verbinding maken met een SMS-provider in Configuration Manager met behulp van beheerde code voor meer informatie.

  2. Roep de WqlConnectionManager-klasse GetInstance-methode aan om het object IResultObject op te halen voor het gewenste object.

  3. De eigenschappen van het IResultObject weergeven.

Voorbeeld

In het volgende codevoorbeeld ziet u hoe u een Configuration Manager-object leest.

Zie Aanroepen Configuration Manager codefragmenten voor meer informatie over het aanroepen van de voorbeeldcode.

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

Deze voorbeeldmethode heeft de volgende parameters:

Parameter Type Beschrijving
Connection -Beheerd: WqlConnectionManager - Een geldige verbinding met de SMS-provider.
PackageID -Beheerd: String Een geldige pakket-id. Verkregen van de eigenschap SMS_Package klasse PackageID.

De code compileren

Naamruimten

Systeem

System.Collections.Generic

System.ComponentModel

Microsoft. ConfigurationManagement.ManagementProvider

Microsoft. ConfigurationManagement.ManagementProvider.WqlQueryEngine

Vergadering

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Robuust programmeren

De Configuration Manager uitzonderingen die kunnen worden gegenereerd, zijn SmsConnectionException en SmsQueryException. Deze kunnen samen met SmsException worden gevangen.

Zie ook

Overzicht van objectenConfiguration Manager Luie eigenschappen
Een Configuration Manager-objectklassemethode aanroepen met behulp van beheerde code
Verbinding maken met een Configuration Manager-provider met behulp van beheerde code
Een Configuration Manager-object maken met behulp van beheerde code
Een Configuration Manager-object wijzigen met behulp van beheerde code
Een asynchrone Configuration Manager-query uitvoeren met behulp van beheerde code
Een synchrone Configuration Manager-query uitvoeren met behulp van beheerde code
Luie eigenschappen lezen met behulp van beheerde code