Een Configuration Manager-object lezen met behulp van beheerde code

Gebruik WqlConnectionManager.GetInstance om een exemplaar van een Configuration Manager-object te lezen met behulp van de beheerde sms-provider. De methode GetInstance gebruikt een tekenreeks die een specifiek objectexemplaar identificeert en retourneert een IResultObject-object dat wordt gebruikt om toegang te krijgen tot het object.

De volgende voorbeeldfunctie toont de naam en beschrijving van een opgegeven pakket-id.

Een Configuration Manager-object lezen

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

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

  3. De eigenschappen van het IResultObject weergeven.

Voorbeeld

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

Zie Codefragmenten van Configuration Manager aanroepen 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 uit de eigenschap PackageID van de klasse SMS_Package .

De code compileren

Naamruimten

Systeem

System.Collections.Generic

System.ComponentModel

Microsoft.ConfigurationManagement.ManagementProvider

Microsoft.ConfigurationManagement.ManagementProvider.WqlQueryEngine

bijeenkomst

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

Robuust programmeren

De uitzonderingen in Configuration Manager die kunnen worden verhoogd zijn SmsConnectionException en SmsQueryException. Deze kunnen samen met SmsException worden opgevangen.

Zie ook

Overzicht van objecten

Lazy eigenschappen van Configuration Manager

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

Lazy eigenschappen lezen met behulp van beheerde code