Hinzufügen eines Configuration Manager-Kontextqualifizierers mithilfe von verwaltetem Code

Um im Configuration Manager mithilfe des verwalteten SMS-Anbieters einen Kontextqualifizierer hinzuzufügen, verwenden Sie die Context-Eigenschaft, bei der es sich um ein Dictionary Objekt handelt, das Kontextqualifizierer enthält.

In der Regel fügen Sie Ihren Anwendungsnamen zusammen mit dem Computernamen (MachineName) und dem Gebietsschemabezeichner (LocaleID) dem Kontextbezeichner ApplicationName hinzu.

So fügen Sie den Configuration Manager-Kontextqualifizierer hinzu

  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 das SmsNamedValuesDictionary-Objekt aus dem WqlConnectionManager-Objekt ab, das Sie aus Schritt 1 erhalten.

  3. Fügen Sie die Kontextbegrenzungszeichen nach Bedarf hinzu.

Beispiel

Das folgende C#-Beispiel fügt zunächst einer Kontextverzeichniseigenschaft eines WQLConnectionManager-Objekts eine Reihe von Kontextqualifizierern hinzu. Anschließend wird eine Liste der Kontextbezeichnungen im Wörterbuchobjekt angezeigt.

Hinweis

WqlConnectionManager leitet sich von ConnectionManagerBase ab.

Im Beispiel ist der LocaleID Kontextbezeichner für Englisch (USA) hartcodiert. Wenn Sie das Gebietsschema für nicht-US-amerikanische können Sie sie aus der Eigenschaft SMS_Identification Server WMI-KlasseLocaleID abrufen.

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

public void AddContextQualifiers(WqlConnectionManager connection)
{
    try
    {
        connection.Context.Add("ApplicationName", "My application name");
        connection.Context.Add("MachineName","Computername");
        connection.Context.Add("LocaleID", @"MS\1033");

        foreach (KeyValuePair<string, object> namedValue in connection.Context)
        {
            Console.WriteLine(namedValue.Key);
            Console.WriteLine(namedValue.Value);
            Console.WriteLine();
        }
    }
    catch (SmsException e)
    {
        Console.WriteLine("Failed to add context qualifier : " + e.Message);
    }
}

Die Beispielmethode hat die folgenden Parameter:

Parameter Typ Beschreibung
connection - WqlConnectionManager Eine gültige Verbindung mit dem SMS-Anbieter.

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

Configuration Manager-KontextqualifiziererSo stellen Sie mithilfe von verwaltetem Code eine Verbindung mit einem Configuration Manager-Anbieter her