Share via


コンソール フォームConfiguration Managerについて

新しい Windows フォームを使用して、Configuration Manager コンソールを拡張できます。 具体的には、フォーム ベースのダイアログ ボックスとプロパティ シートを追加できます。 ユーザーは、定義Configuration Managerアクションからこれらのフォームにアクセスします。

注:

ウィザードは、Configuration Manager コンソールで使用される別の Windows フォームですが、Configuration Manager コンソール フレームワークを使用してウィザードを拡張または追加することはできません。 ただし、Configuration Managerアクションを使用して、独自のウィザード ソリューションを実行できます。

Configuration Managerでは、フォームは、適切なアクションが選択された後にConfiguration Manager コンソールによって呼び出されるアセンブリ.NET Frameworkに格納されます。

拡張フォームの作成

拡張フォームを作成するには、次の操作を行います。

  • 拡張フォーム アセンブリを作成します。

  • 拡張フォーム アクション XML を作成します。

  • 拡張フォーム XML を作成します。

拡張フォーム アセンブリを作成する

プロパティ シート

プロパティ シートは、定義した 1 つ以上のプロパティ ページで構成されます。 プロパティ ページを既存のConfiguration Managerプロパティ シートに統合することもできます。

プロパティ シートを作成するには、Visual Studio で Windows コントロール ライブラリ プロジェクトを作成します。 このプロジェクトでは、Microsoftから継承するクラスを作成します。ConfigurationManagement.AdminConsole.SmsPageControl クラス。 このクラスは、プロパティ ページに表示するコントロールを実装します。 プロパティ シートでは、必要なプロパティ ページごとに SmsPageControl クラスを作成します。 Configuration Manager SDK のプロパティ シート プロトタイプ サンプルには、使用できる完全なソリューションがあります。 詳細については、「Configuration Manager プロパティ シートを作成する方法」を参照してください。

ダイアログ ボックス

Configuration Managerのダイアログ ボックスは、一般的なモードレス ダイアログ ボックスのように表示されます。 SMSPageControl を作成し、フォーム XML で "ダイアログ" を指定します。 詳細については、「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 説明
PropertySheet フォームはプロパティ シートです。
ダイアログ フォームはダイアログ ボックスです。

アクションが選択されると、Configuration Manager コンソールはプロパティ シート XML を使用して、フォームを読み込んで表示するために必要なアセンブリを決定します。

詳細については、「Configuration Manager プロパティ シートのフォーム XML を作成する方法」を参照してください。

フォームでのオブジェクト データの管理

Configuration Manager フォームは、カスタム データを渡すことができます。また、結果ウィンドウからクエリから返されるオブジェクトも渡すことができます。 結果ウィンドウから選択したオブジェクトは、 PropertyManager オブジェクトを使用してフォームで使用できます。 詳細については、「Configuration Manager フォームに渡されるオブジェクトを使用する方法」を参照してください。 フォーム コントロールは、フォームの に渡されるオブジェクトに PropertyManagerバインドできます。 詳細については、「Configuration Manager データをフォームにバインドする方法」を参照してください。

Configuration Manager コンソールは、フォームが閉じられたときにフォームに渡Configuration Managerオブジェクトをシリアル化します。

クエリ

マネージド SMS プロバイダーを使用して、フォームで同期クエリと非同期クエリの両方を実行できます。 Microsoftが表示されます。フォームの ConnectionManager の ConfigurationManagement.AdminConsole.SmsPageControl.QueryProcessor オブジェクト。PropertyManager 取得後、コードは SMS プロバイダーの例と同じです。 同期クエリの例については、「マネージド コードを使用して同期Configuration Manager クエリを実行する方法」を参照してください。

非同期クエリの例については、「マネージ コードを使用して非同期Configuration Manager クエリを実行する方法」を参照してください。

関連項目

既存のConfiguration Manager プロパティ シートにプロパティ ページを追加する方法
Configuration Manager データをフォームにバインドする方法
Configuration Manager プロパティ シートを作成する方法
[Configuration Manager] ダイアログ ボックスのアクション XML を作成する方法
Configuration Manager プロパティ シートのアクション XML を作成する方法
[Configuration Manager] ダイアログ ボックスを作成する方法
[Configuration Manager] ダイアログ ボックスのフォーム XML を作成する方法
Configuration Manager プロパティ シートのフォーム XML を作成する方法
Configuration Manager フォームに渡されるオブジェクトを使用する方法