Gedrag van hoofdnavigatie voor een oplossingsextensie wijzigen

In dit artikel vindt u richtlijnen voor het wijzigen van het hoofdnavigatiegedrag voor uw oplossing om verschillende gedrag in de lijst met verbindingen te hebben. U leert ook hoe u de lijst met hulpprogramma's kunt verbergen of weergeven.

Basisnavigatiegedrag wijzigen

Open manifest.json bestand in {extension root}\src en zoek de eigenschap rootNavigationBehavior. Deze eigenschap heeft twee geldige waarden: "verbindingen" of "pad". Het gedrag van verbindingen wordt verderop in de documentatie beschreven.

Pad instellen als hoofdnavigatiegedrag

Stel de waarde van rootNavigationBehavior in op pathen verwijder de requirements eigenschap en laat de path eigenschap staan als een lege tekenreeks. U hebt de minimaal vereiste configuratie voltooid om een oplossingsextensie te bouwen. Sla het bestand op, voer gulp build -> gulp serve uit als met een hulpprogramma, en side load vervolgens de extensie in uw lokale Windows Admin Center-extensie.

Een geldige manifestinvoerpointsmatrix ziet er als volgt uit:

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

Hulpprogramma's die met dit soort structuur zijn gebouwd, vereisen geen verbindingen om te laden, maar hebben ook geen functionaliteit voor knooppuntconnectiviteit.

Verbindingen instellen als rootNavigationBehavior

Wanneer u de rootNavigationBehavior eigenschap connectionsinstelt op, laat u de Windows Admin Center Shell weten dat er een verbonden knooppunt is (altijd een server van een bepaald type) waarmee verbinding moet worden gemaakt om de verbindingsstatus te controleren. Er zijn twee stappen voor het verifiëren van een verbinding.

1. Windows Admin Center probeert in te loggen op het knooppunt met uw referenties (voor het tot stand brengen van de externe PowerShell-sessie).
2. Windows Admin Center voert het PowerShell-script uit dat u opgeeft om te controleren of het knooppunt een verbindingsstatus heeft.

Een geldige oplossingsdefinitie met verbindingen ziet er als volgt uit:

        {
          "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"
            }
        },

Wanneer de rootNavigationBehavior is ingesteld op 'verbindingen', moet u de definitie van de verbindingen in het manifest uitbouwen. Dit omvat de eigenschap 'header' (wordt weergegeven in de oplossingskoptekst wanneer een gebruiker deze selecteert in het menu) en een connectionTypes-matrix (geeft aan welke connectionTypes worden gebruikt in de oplossing. Meer informatie hierover in de documentatie van ConnectionProvider.

Het menu van hulpmiddelen in- en uitschakelen

Een andere eigenschap die beschikbaar is in de oplossingsdefinitie is de eigenschap Hulpmiddelen. De eigenschap Extra bepaalt of het menu Extra wordt weergegeven en welk hulpprogramma wordt geladen. Wanneer dit is ingeschakeld, wordt in het Windows-beheercentrum het menu Extra aan de linkerkant weergegeven. Met defaultTool moet u een invoerpunt voor het hulpprogramma toevoegen aan het manifest om de juiste resources te laden. De waarde van 'defaultTool' moet de eigenschap 'name' van het hulpprogramma zijn, zoals deze is gedefinieerd in het manifest.