マネージド コードを使用してConfiguration Manager コンテキスト修飾子を追加する方法

Configuration Managerで、マネージド SMS プロバイダーを使用してコンテキスト修飾子を追加するには、コンテキスト修飾子を保持するオブジェクトである Dictionary Context プロパティを使用します。

通常、アプリケーション名を ApplicationName コンテキスト修飾子に、コンピューター名 (MachineName) とロケール識別子 (LocaleID) と共に追加します。

コンテキスト修飾子Configuration Manager追加するには

1. SMS プロバイダーへの接続を設定します。 詳細については、「マネージド コードを使用してConfiguration Managerで SMS プロバイダーに接続する方法」を参照してください。

2. 手順 1 で取得した WqlConnectionManager オブジェクトから SmsNamedValuesDictionary オブジェクトを取得します。

3. 必要に応じてコンテキスト修飾子を追加します。

例

次の C# の例では、最初に、WQLConnectionManager オブジェクトのコンテキスト ディクショナリ プロパティに多数の コンテキスト 修飾子を追加します。 次に、ディクショナリ オブジェクトのコンテキスト修飾子の一覧が表示されます。

注:

WqlConnectionManager はConnectionManagerBase から派生します。

この例では、 LocaleID コンテキスト修飾子は英語 (米国) にハードコーディングされています。 米国以外のロケールが必要な場合。インストールでは、 SMS_Identification サーバー WMI クラスLocaleID プロパティから取得できます。

サンプル コードの呼び出しについては、「Configuration Manager コード スニペットの呼び出し」を参照してください。

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

このメソッドの例には、次のパラメーターがあります。

パラメーター	型	説明
connection	- WqlConnectionManager	SMS プロバイダーへの有効な接続。

コードのコンパイル

名前空間

System

System.Collections.Generic

System.ComponentModel

Microsoft。ConfigurationManagement.ManagementProvider

Microsoft。ConfigurationManagement.ManagementProvider.WqlQueryEngine

Assembly

microsoft.configurationmanagement.managementprovider

adminui.wqlqueryengine

堅牢なプログラミング

発生できるConfiguration Manager例外は、SmsConnectionException と SmsQueryException です。 これらは SmsException と一緒にキャッチできます。

関連項目

Configuration Manager コンテキスト修飾子
マネージド コードを使用してConfiguration Manager プロバイダーに接続する方法