Modifier le comportement de navigation racine pour une extension de solution

Cet article fournit des conseils sur la façon de modifier le comportement de navigation racine pour que votre solution ait un comportement différent de la liste de connexions. Vous allez également apprendre à masquer ou à afficher la liste des outils.

Modification du comportement de navigation racine

Ouvrez le fichier manifest.json dans {extension root}\src, puis recherchez la propriété « rootNavigationBehavior ». Cette propriété a deux valeurs valides : « connections » ou « path ». Le comportement des « connexions » est détaillé plus loin dans la documentation.

Définition du chemin d’accès en tant que rootNavigationBehavior

Définissez la valeur de rootNavigationBehavior sur path, puis supprimez la propriété requirements et laissez la propriété path comme chaîne vide. Vous avez terminé la configuration minimale requise pour créer une extension de solution. Enregistrez le fichier, exécutez gulp build - >gulp serve comme vous le feriez avec un outil, puis chargez l’extension dans votre extension Windows Admin Center locale.

Un tableau entryPoints de manifestes valide se présente comme suit :

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

Les outils construits avec ce type de structure ne nécessitent aucune connexion pour se charger, mais ne disposent pas non plus de fonctionnalité de connectivité entre nœuds.

Définition des connexions en tant que rootNavigationBehavior

Lorsque vous définissez la propriété rootNavigationBehavior sur connections, vous indiquez à l’interpréteur de commande Windows Admin Center qu’il existe un nœud connecté (toujours un serveur d’un type quelconque) auquel il doit se connecter pour vérifier l’état de la connexion. Il existe deux étapes pour vérifier une connexion.

1. Windows Admin Center tente de se connecter au nœud à l’aide de vos informations d’identification (pour établir la session PowerShell à distance).
2. Windows Admin Center exécute le script PowerShell que vous fournissez pour vérifier si le nœud est dans un état connectable.

Une définition de solution valide avec des connexions ressemble à ceci :

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

Lorsque rootNavigationBehavior est défini sur « connexions », vous devez générer la définition des connexions dans le manifeste. Elle comprend la propriété « header » (affichée dans l’en-tête de votre solution lorsqu’un utilisateur la sélectionne dans le menu) et un tableau connectionTypes (qui spécifie les types de connexion utilisés dans la solution). Pour plus d’informations, consultez la documentation sur connectionProvider.

Activation et désactivation du menu outils

Une autre propriété disponible dans la définition de la solution est la propriété Tools. La propriété Tools détermine si le menu Tools s’affiche et quel outil sera chargé. Lorsque cette option est activée, Windows Admin Center affiche le menu Tools à gauche. Avec defaultTool, vous devez ajouter un point d’entrée d’outil au manifeste afin de charger les ressources appropriées. La valeur « defaultTool » doit être la propriété « name » de l’outil telle qu’elle est définie dans le manifeste.