コンソール拡張機能のデプロイConfiguration Manager

2025-03-04

一般的なConfiguration Manager拡張機能のデプロイでは、アクション、フォーム、ビュー、管理クラス、ノード拡張機能を考慮する必要があります。

Configuration Manager拡張機能をデプロイするときは、次のディレクトリにファイルをインストールします。

拡張機能の種類	ディレクトリ
アクション	アセンブリの %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin % ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Actions for the action XML files
Forms	%アセンブリの ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin %フォーム XML ファイルの ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms
ビュー	%アセンブリの ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\bin
Nodes	アセンブリの %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin % ProgramFiles%Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes for the node XML files
ManagementClasses	アセンブリの %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin %ProgramFiles%Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\ManagementClasses for the management classes XML files

重要

%ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin フォルダーにアセンブリと依存関係を配置すると、他のコンソール拡張機能と競合し、拡張機能の読み込みが妨げる可能性があります。

また、アクションのインストールとアンインストール中に、次のタスクを実行する必要もあります。

ユーザー設定のアクション

カスタムアクションのインストール

カスタムアクション XML ファイルをインストールするには、ファイルを %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Actions\<GUID> フォルダーにコピーします。ここで、 <GUID> はアクションが適用されるノードの GUID 識別子です。

カスタムアクションの削除

カスタムアクションを削除するには、カスタムアクション XML ファイルを削除します。フォルダーに他の XML ファイルがない場合は、フォルダーを削除しても安全です。

Forms

フォームのインストール

フォームアセンブリを %ProgramFiles%\ Microsoft Endpoint Manager\AdminConsole\bin またはアプリケーションのインストールフォルダーにコピーします。

%ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin フォルダー以外のディレクトリに展開する場合は、xml<Assembly> 形式の属性 Name、アセンブリファイル名とファイルへの完全なパスを含める必要があります。詳細については、「Configuration Manager プロパティシートのフォーム XML を作成する方法」を参照してください。

フォームの拡張プロパティシート XML ファイルをインストールするには、ファイルを %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms フォルダーにコピーします。すべての拡張フォームがこのフォルダーに配置されるため、XML ファイルの名前が一意であることを確認する必要があります。ファイル名の一部として会社名を使用することをお勧めします。

フォームが既存のプロパティシートの拡張機能である場合は、プロパティシートが Extensions\Forms フォルダーに既に存在するかどうかを判断し、プロパティページをそのプロパティシートに追加する必要があります。

Configuration Manager コンソールが読み込まれると、既存のプロパティシートに優先して Extensions\Forms フォルダー内のプロパティシートが読み込まれます。

Page 要素の VendorId 属性を使用する必要があります。これは、他のベンダーが拡張機能の変更を識別して回避できるためです。

フォームの削除

既存のプロパティシートを拡張しないフォームを削除するには、フォルダー %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms からプロパティシート XML ファイルを削除します。

既存のプロパティシートに追加したプロパティページを削除するには、プロパティシートで次のアクションを実行する必要があります。

Microsoft Corporation 以外の VendorID のプロパティページを確認します。存在しない場合は、Extensions\Forms フォルダーからプロパティシート XML ファイルを削除しても安全です。
他の VendorID が存在する場合は、プロパティシートからプロパティページ XML を削除し、プロパティシートを Extensions\Forms フォルダーのままにします。

ビュー

ビューのインストール

ビューをインストールするには、ビューアセンブリを %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin フォルダー、またはアプリケーションのインストールフォルダーにコピーします。

%ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin 以外のフォルダーに展開する場合は、node XML<Assembly> 要素にアセンブリファイル名とファイルへの完全なパスを含める必要があります。詳細については、「Configuration Manager コンソールビューのノード XML を作成する方法」を参照してください。

また、ビューをConfiguration Manager コンソールに統合するノード XML を %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes\<GUID フォルダー>にコピーする必要があります。ここで、<GUID> はアクションが適用されるノードの GUID 識別子です。詳細については、このトピックの後半の「ノード」セクションを参照してください。

ビューの削除

ビューを削除するには、%ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\bin フォルダーからビューアセンブリを削除します。ビューを削除する前に、ビューを参照している拡張機能が他にないことを確認する必要があります。また、ビューのノード XML ファイルを %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes\<GUID> フォルダーから削除する必要があります。ここで、 <GUID> はアクションが適用されるノードの GUID 識別子です。

カスタム管理クラス

カスタム管理クラスのインストール

管理クラスアセンブリを %ProgramFiles%\ Microsoft Endpoint Manager\AdminConsole\bin またはアプリケーションのインストールフォルダーにコピーします。

カスタム管理クラス XML ファイルをインストールするには、ファイルを %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\ManagementClasses フォルダーにコピーします。すべてのカスタム管理クラスがこのフォルダーに配置されるため、XML ファイルの名前が一意であることを確認する必要があります。ファイル名の一部として会社名を使用することをお勧めします。

カスタム管理クラスの削除

カスタム管理クラスを削除するには、カスタム管理クラス XML ファイルを削除します。フォルダーに他の XML ファイルがない場合は、フォルダーを削除しても安全です。

Nodes

ノードのインストール

ノードをインストールするには、フォルダー %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes\<GUID> を作成します。ここで、<GUID> はConfiguration Managerコンソール親ノードの GUID 識別子です。ノード XML ファイルを GUID フォルダーにコピーします。詳細については、「コンソールノードについて」を参照してください。

ノードの削除

ノードを削除するには、%ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Nodes\<GUID> フォルダーからノード XML ファイルを削除します。