ソリューション拡張機能の開発
適用先:Windows Admin Center、Windows Admin Center Preview
ソリューションは、主に Windows Admin Center で管理する一意の種類のオブジェクトを定義します。 既定では、これらのソリューション/接続の種類は Windows Admin Center に含まれています:
- Windows サーバー接続
- Windows PC 接続
- フェールオーバークラスター接続
- ハイパー集約型クラスター接続
Windows Admin Center の [接続] ページから接続を選択すると、その接続の種類のソリューション拡張が読み込まれ、Windows Admin Center がターゲットノードへへ接続しようとします。 接続に成功すると、ソリューション拡張機能の UI が読み込まれ、Windows Admin Center には、そのソリューションのツールが左側のナビゲーション ウィンドウに表示されます。
上記の既定の接続の種類 (ネットワーク スイッチなど) で定義されていないサービス、またはコンピューター名で検出できないその他のハードウェアの管理 GUI を構築する場合は、独自のソリューション拡張機能を作成することをお勧めします。
注意
さまざまな拡張機能の種類に慣れていない場合 拡張機能のアーキテクチャと拡張機能の種類の詳細について説明します。
環境を準備する
まだインストールしていない場合は、すべてのプロジェクトに必要な依存関係とグローバルな前提条件をインストールして 環境を準備 します。
Windows Admin Center SDK を使用してツール拡張機能を作成する
すべての依存関係をインストールしたら、新しいソリューション拡張機能を作成できます。 プロジェクト ファイルを格納するフォルダーを作成または参照し、コマンド プロンプトを開き、そのフォルダーを作業ディレクトリとして設定します。 以前にインストールされた Windows Admin Center SDK を使用して、次の構文を使用して新しい拡張機能を作成します:
wac create --company "{!Company Name}" --solution "{!Solution Name}" --tool "{!Tool Name}" --version latest
| 値 | 説明 | 例 |
|---|---|---|
{!Company Name} |
会社名 (スペースを含む) | Contoso Inc |
{!Solution Name} |
ソリューション名 (スペースを含む) | Contoso Foo Works Suite |
{!Tool Name} |
ツール名 (スペースを含む) | Manage Foo Works |
次に使用方法の例を示します。
wac create --company "Contoso Inc" --solution "Contoso Foo Works Suite" --tool "Manage Foo Works"
これにより、ソリューションに指定した名前を使用して、現在の作業ディレクトリ内に新しいフォルダーが作成され、必要なすべてのテンプレート ファイルがプロジェクトにコピーされ、会社名、ソリューション名とツール名でファイルが構成されます。
注意
このコマンドの --version フラグは、対象とする Windows Admin Center SDK のバージョンを指定します。 最新の SDK とプラットフォームの変更に合わせて拡張機能を最新の状態に保つために、Windows Admin Center SDK の 別のバージョン をターゲットにする 方法について説明します。
次に、作成したフォルダーにディレクトリを変更し、次のコマンドを実行して必要なローカルの依存関係をインストールします:
npm install
これが完了すると、新しい拡張機能を Windows Admin Center に読み込むために必要なすべての設定が完了します。
拡張機能にコンテンツを追加する
Windows Admin Center SDK を使用して拡張機能を作成したので、コンテンツをカスタマイズする準備ができました。 実行できる操作の例については、次のガイドを参照してください:
- 空のモジュールを追加する
- iFrame を追加する
- カスタム接続プロバイダーを作成する
- ルート ナビゲーション動作を変更する
その他の例については、開発者ガイドを参照してください。 開発者ガイドは、完全に機能するソリューションの拡張機能であり、Windows Admin Center にサイドロードすることができます。また、独自の拡張機能で参照して使用できる、サンプル機能とツール例の豊富なコレクションが含まれています。
Windows Admin Center 設定の[詳細設定] ページで、開発者ガイド拡張機能を有効にします。
拡張機能をビルドしてサイドロードする
次に、拡張機能をビルドして Windows Admin Center に読み込みます。 コマンド ウィンドウを開き、ディレクトリをソース ディレクトリに変更すると、ビルドする準備が整います。
次のように gulp build および gulp serve を指定します。
gulp build gulp serve --port 4201
現在空いているポートを選択する必要があることに注意してください。 Windows Admin Center が実行されているポートは使用しないでください。
ローカルで提供されるプロジェクトを Windows Admin Center に追加することで、プロジェクトをテスト用に Windows Admin Center のローカル インスタンスにサイド ローディングすることができます。
Web ブラウザーで Windows Admin Center を起動します
デバッガーを起動します (F12)
コンソールを開き、次のコマンドを入力します
MsftSme.sideLoad("http://localhost:4201")Web ブラウザーを更新します
これで、プロジェクトは、名前の横に (side loaded) が追加された状態でツール一覧に表示されるようになります。