共用方式為

修改解決方案延伸模組的根導覽行為

  • 發行項
  • 適用於:
    ✅ Windows Admin Center, ✅ Windows Admin Center Preview

本文提供有關如何修改解決方案的根導覽行為以具有不同的連線清單行為的指引。 您也將了解如何隱藏或顯示工具清單。

修改根導覽行為

開啟 {extension root}\src 中的 manifest.json 檔案，並找到 "rootNavigationBehavior" 屬性。 此屬性有兩個有效值："connections" 或 "path"。 "connections" 行為稍後將在文件中詳細說明。

將路徑設為 rootNavigationBehavior

將 rootNavigationBehavior 的值設為 path，然後刪除 requirements 屬性，並將 path 屬性保留為空字串。 您已完成建置解決方案延伸模組所需的最少設定。 儲存該檔案，執行 gulp build -> gulp serve，就像您使用工具一樣，然後將該延伸模組側載到本機 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 Shell 有一個它應該連接以驗證連線狀態的已連接節點 (始終是某種類型的伺服器)。 驗證連線有兩個步驟。

  1. Windows Admin Center 會嘗試使用您的認證資料來登入該節點 (以建立遠端 PowerShell 工作階段)。
  2. 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 文件。

啟用和停用工具功能表

解決方案定義中可用的另一個屬性是 Tools 屬性。 Tools 屬性可決定是否顯示 [工具] 功能表以及將載入哪個工具。 啟用時，Windows Admin Center 會呈現左側 [工具] 功能表。 使用 defaultTool 時，您必須將工具進入點新增至資訊清單中，才能載入適當的資源。 "defaultTool" 的值必須是如在資訊清單中所定義的工具的 "name" 屬性的值。