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, gulp build :> gulp sert comme vous le feriez pour un outil, puis chargez l’extension de côté 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 créés avec ce type de structure ne nécessitent pas de connexions pour le chargement, mais n’ont pas non plus de fonctionnalités de connectivité de nœud.
Définition des connexions en tant que rootNavigationBehavior
Lorsque vous définissez la propriété rootNavigationBehavior sur connections, vous indiquez au Windows Admin Center Shell qu’il existe un nœud connecté (toujours un serveur) auquel il doit se connecter pour vérifier l’état de la connexion. Il existe deux étapes pour vérifier une connexion.
- Windows Admin Center tente de se connecter au nœud avec vos informations d’identification (pour établir la session PowerShell distante).
- 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 se présente comme suit :
{
"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. Cela inclut la propriété « header » (apparaît dans l’en-tête de votre solution lorsqu’un utilisateur le sélectionne dans le menu) et un tableau connectionTypes (spécifie les connectionTypes utilisés dans la solution. Pour plus d’informations à ce sujet, consultez la documentation connectionProvider.
Activation et désactivation du menu outils
Une autre propriété disponible dans la définition de solution est la propriété Outils. La propriété Outils détermine si le menu Outils est affiché et quel outil sera chargé. Lorsque cette option est activée, Windows Admin Center affiche le menu Outils de gauche. Avec defaultTool, vous devez ajouter un point d’entrée d’outil au manifeste afin de charger les ressources appropriées. La valeur de « defaultTool » doit être la propriété « name » de l’outil telle qu’elle est définie dans le manifeste.