ルートナビゲーション動作の変更

[アーティクル]
05/30/2023
適用対象:

✅ Windows Admin Center, ✅ Windows Admin Center Preview

この記事では、ソリューションのルートナビゲーション動作を変更して、さまざまな接続リストの動作を実現する方法に関するガイダンスを提供します。また、ツールの一覧を非表示または表示する方法についても説明します。

{extension root}\src でmanifest.json ファイルを開き、プロパティ "rootNavigationBehavior" を見つけます。このプロパティには、"connections" または "path" という 2 つの有効な値があります。 "connections" の動作については、ドキュメントの後半で詳しく説明します。

RootNavigationBehavior としてのパスの設定

rootNavigationBehavior の値を path に設定し、requirements プロパティを削除して path プロパティを空の文字列のままにします。ソリューション拡張機能をビルドするために必要な最小限の構成が完了しました。ファイルを保存し、gulp ビルドを行います。> gulp は、ツールのように機能します。拡張機能をローカル Windows Admin Center の拡張機能にサイドロードします。

有効なマニフェスト entryPoints 配列は次のようになります:

    "entryPoints": [
        {
          "entryPointType": "solution",
          "name": "main",
          "urlName": "testsln",
          "displayName": "resources:strings:displayName",
          "description": "resources:strings:description",
          "icon": "sme-icon:icon-win-powerShell",
          "path": "",
          "rootNavigationBehavior": "path"
        }
    ],

この種類の構造で構築されたツールでは、読み込むために接続する必要はありませんが、ノード接続機能も使用できません。

RootNavigationBehavior としての接続の設定

rootNavigationBehavior プロパティを connections に設定すると、接続の状態を確認するために、接続先のノード (常に何らかの種類のサーバー) が接続されていることを Windows Admin Center シェルに伝えます。接続の確認には 2 つの手順があります。

Windows Admin Center は、(リモート PowerShell セッションを確立するために) 資格情報を使用してノードにログインしようとします。
Windows Admin Center は、指定した PowerShell スクリプトを実行して、ノードが接続可能な状態であるかどうかを確認します。

接続を含む有効なソリューション定義は次のようになります。

        {
          "entryPointType": "solution",
          "name": "example",
          "urlName": "solutionexample",
          "displayName": "resources:strings:displayName",
          "description": "resources:strings:description",
          "icon": "sme-icon:icon-win-powerShell",
          "rootNavigationBehavior": "connections",
          "connections": {
            "header": "resources:strings:connectionsListHeader",
            "connectionTypes": [
                "msft.sme.connection-type.example"
                ]
            },
            "tools": {
                "enabled": false,
                "defaultTool": "solution"
            }
        },

RootNavigationBehavior が "connections" に設定されている場合は、マニフェスト内の接続定義を構築する必要があります。これには、"header" プロパティ (ユーザーがメニューから選択したときにソリューションヘッダーに表示される)、と connectionTypes 配列 (ソリューションで使用する connectionTypes を指定する) が含まれます。詳細については、connectionProvider のドキュメントを参照してください。

ソリューション定義で使用できるもう 1 つのプロパティは、Tools プロパティです。 Tools プロパティは、[ツール] メニューを表示するかどうか、および読み込むツールを決定します。有効にすると、Windows Admin Center の左側に [ツール] メニューが表示されます。 defaultTool では、適切なリソースを読み込むために、マニフェストにツールのエントリポイントを追加する必要があります。 "defaultTool" の値は、マニフェストで定義されているツールの "name" プロパティである必要があります。

次の方法で共有

ソリューション拡張機能のルートナビゲーション動作を変更する