新しい Windows フォームで Configuration Manager コンソールを拡張できます。 具体的には、フォーム ベースのダイアログ ボックスとプロパティ シートを追加できます。 ユーザーは、定義した Configuration Manager アクションからこれらのフォームにアクセスします。
注:
ウィザードは、Configuration Manager コンソールで使用される別の Windows フォームですが、Configuration Manager コンソール フレームワークを使用してウィザードを拡張または追加することはできません。 ただし、Configuration Manager のアクションを使用して独自のウィザード ソリューションを実行できます。
Configuration Manager では、フォームは .NET Framework アセンブリに保存され、適切な操作が選択された後に Configuration Manager コンソールによって呼び出されます。
拡張フォームの作成
拡張フォームを作成するには、次の操作を行います。
拡張フォーム アセンブリを作成します。
拡張機能フォームのアクション XML を作成します。
拡張フォーム XML を作成する。
拡張フォーム アセンブリを作成する
プロパティ シート
プロパティ シートは、定義した 1 つ以上のプロパティ ページで構成されます。 プロパティ ページを既存の Configuration Manager プロパティ シートに統合することもできます。
プロパティ シートを作成するには、Visual Studio で Windows コントロール ライブラリ プロジェクトを作成します。 このプロジェクトでは、 Microsoft.ConfigurationManagement.AdminConsole.SmsPageControl クラスから継承するクラスを作成します。 このクラスは、プロパティ ページに表示するコントロールを実装します。 プロパティ シートで、必要なプロパティ ページごとに SmsPageControl クラスを作成します。 Configuration Manager SDK のプロパティ シート プロトタイプ サンプルには、使用できる完全なソリューションがあります。 詳細については、「Configuration Manager プロパティ シートを作成する方法」を参照してください。
ダイアログ ボックス
Configuration Manager のダイアログ ボックスは、通常のモードレス ダイアログ ボックスのように表示されます。 SMSPageControl を作成し、フォーム XML に "Dialog" を指定します。 詳細については、「Configuration Manager ダイアログ ボックスを作成する方法」を参照してください。
フォーム アクション XML を作成する
アクションは、呼び出された拡張機能の種類と、アクションが Configuration Manager コンソール ユーザー インターフェイスに配置される場所について説明します。 拡張フォームの場合は、 ShowDialog アクションの種類を使用してフォームを表示します。 詳細については、「Configuration Manager プロパティ シートのアクション XML を作成する方法」を参照してください。
アクションの詳細については、「Configuration Manager コンソール アクションについて」を参照してください。
フォームのプロパティ シート XML を作成する
フォームがプロパティ シートであるかどうかにかかわらず、フォームには、フォームのアセンブリ、名前空間、および型を定義するフォーム XML ファイルがあります。 プロパティ シートでは、プロパティ シートのプロパティ ページの順序を定義します。 すべての Configuration Manager コンソール フォーム用のプロパティ シート XML ファイルがあります。
注:
Configuration Manager コンソールのプロパティ シート XML ファイルは、%ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Forms に格納されています。
新しいフォームを作成するときに、新しいプロパティ シートの XML ファイルを作成します。 既存のプロパティ シートに新しいプロパティ ページを追加する場合は、プロパティ ページの XML を既存のプロパティ シート XML ファイルと結合します。
注:
拡張子のプロパティ シートは、 %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms に格納されています。
フォーム XML の展開の詳細については、「Configuration Manager コンソール拡張機能の展開」を参照してください。
ダイアログ ボックスとプロパティ シートのどちらを表示するかに応じて、FormType 属性値を設定する必要があります。
| FormType | 説明 |
|---|---|
| プロパティシート | フォームはプロパティ シートです。 |
| ダイアログ | フォームはダイアログ ボックスです。 |
操作が選択されると、Configuration Manager コンソールはプロパティ シート XML を使用して、フォームの読み込みと表示に必要なアセンブリを決定します。
詳細については、「Configuration Manager プロパティ シートのフォーム XML を作成する方法」を参照してください。
フォームでのオブジェクト データの管理
Configuration Manager フォームには、カスタム データを渡すことができ、また、クエリから返されたオブジェクトを結果ペインから渡すことができます。 結果ペインから選択したオブジェクトは、 PropertyManager オブジェクトを介してフォームで使用できます。 詳細については、「Configuration Manager フォームに渡されるオブジェクトを使用する方法」を参照してください。 フォーム コントロールは、フォームの PropertyManagerに渡されたオブジェクトにバインドできます。 詳細については、「フォームに Configuration Manager のデータをバインドする方法」を参照してください。
Configuration Manager コンソールは、フォームが閉じられたときにフォームに渡された Configuration Manager オブジェクトをシリアル化します。
クエリ
マネージド SMS プロバイダーを使用すると、フォーム内で同期クエリと非同期クエリの両方を実行できます。
Microsoft.ConfigurationManagement.AdminConsole.SmsPageControl.QueryProcessor オブジェクトはフォームの PropertyManagerConnectionManager から取得します。 取得後のコードは、SMS プロバイダーの例と同じになります。 同期クエリの例については、「マネージド コードを使用して同期 Configuration Manager クエリを実行する方法」を参照してください。
非同期クエリの例については、「マネージド コードを使用して非同期 Configuration Manager クエリを実行する方法」を参照してください。
関連項目
既存の Configuration Manager のプロパティ シートにプロパティ ページを追加する方法 フォームに Configuration Manager のデータをバインドする方法Configuration Manager のプロパティ シートを作成する方法Configuration Manager のアクション XML を作成する方法ダイアログ ボックスConfiguration Manager プロパティ シートのアクション XML を作成する方法Configuration Manager ダイアログ ボックスを作成する方法Configuration Manager ダイアログ ボックス用のフォーム XML を作成する方法Configuration Manager のプロパティ シートConfiguration Manager フォームに渡されたオブジェクトを使用する方法