Développer une extension d’outil

  • Article

S'applique à : Windows Admin Center, Windows Admin Center Preview

Une extension d’outil est la principale façon dont les utilisateurs interagissent avec Windows Admin Center pour gérer une connexion, par exemple un serveur ou un cluster. Lorsque vous cliquez sur une connexion dans l’écran d’accueil du Windows Admin Center et que vous vous connectez, une liste d’outils s’affiche dans le volet de navigation gauche. Lorsque vous cliquez sur un outil, l’extension de l’outil est chargée et affichée dans le volet droit.

Quand une extension d’outil est chargée, elle peut exécuter des appels WMI ou des scripts PowerShell sur un serveur ou un cluster cible et afficher des informations dans l’interface utilisateur ou exécuter des commandes en fonction de l’entrée d’utilisateur. Les extensions d’outils définissent les solutions pour lesquelles elles doivent être affichées, ce qui donne lieu à un ensemble d’outils différent pour chaque solution.

Notes

Vous n’êtes pas familiarisé avec les différents types d’extension ? En savoir plus sur l’architecture d’extensibilité et les types d’extension.

Préparation de votre environnement

Si ce n’est pas déjà fait, préparez votre environnement en installant les dépendances et les prérequis globaux requis pour tous les projets.

Créer une extension d’outil avec le SDK de Windows Admin Center

Une fois que toutes les dépendances sont installées, vous êtes prêt à créer votre nouvelle extension d’outil. Créez ou accédez à un dossier qui contient vos fichiers de projet, ouvrez une invite de commande et définissez ce dossier comme répertoire de travail. À l’aide du Kit de développement logiciel (SDK) Windows Admin Center qui a été installé précédemment, créez une extension avec la syntaxe suivante :

wac create --company "{!Company Name}" --tool "{!Tool Name}" --version latest
Valeur Explication Exemple
{!Company Name} Nom de votre entreprise (avec espaces) Contoso Inc
{!Tool Name} Nom de votre outil (avec espaces) Manage Foo Works

Voici un exemple d’utilisation :

wac create --company "Contoso Inc" --tool "Manage Foo Works" --version latest

Cela crée un dossier à l’intérieur du répertoire de travail actuel en utilisant le nom que vous avez spécifié pour votre outil, copie tous les fichiers de modèles nécessaires dans votre projet et configure les fichiers avec le nom de votre entreprise et de l’outil.

Notes

L’indicateur --version de cette commande spécifie la version du kit SDK Windows Admin Center à cibler. Découvrez comment cibler une autre version du kit SDK Windows Admin Center pour maintenir votre extension à jour avec les derniers changements apportés au kit SDK et à la plateforme.

Ensuite, remplacez le répertoire dans le dossier que vous venez de créer, puis installez les dépendances locales requises en exécutant la commande suivante :

npm install

Une fois cette opération terminée, vous avez configuré tout ce dont vous avez besoin pour charger votre nouvelle extension dans Windows Admin Center.

Ajouter du contenu à votre extension

Maintenant que vous avez créé une extension avec le Kit de développement logiciel (SDK) Windows Admin Center, vous êtes prêt à personnaliser le contenu. Consultez ces guides pour obtenir des exemples de ce que vous pouvez faire :

Vous trouverez d’autres exemples dans notre guide du développeur. Le Guide du développeur est une extension de solution entièrement fonctionnelle qui peut être chargée de manière latérale dans Windows Admin Center, et contient une collection complète d’exemples de fonctionnalités et d’exemples d’outils que vous pouvez parcourir et utiliser dans votre propre extension.

Activez l’extension du Guide du développeur dans la page Avancé de vos paramètres Windows Admin Center.

Personnaliser l’icône de votre extension

Vous pouvez personnaliser l’icône qui s’affiche pour votre extension dans la liste d’outils. Pour ce faire, modifiez toutes les entrées icon dans manifest.json pour votre extension :

"icon": "{!icon-uri}",
Valeur Explication Exemple d'URI
{!icon-uri} Emplacement de votre ressource icône assets/foo-icon.svg

REMARQUE : actuellement, les icônes personnalisées ne sont pas visibles lorsque vous chargez votre extension en mode dev. Pour contourner ce problème, supprimez le contenu de target comme suit :

"target": "",

Cette configuration n’est valide que pour le chargement latéral en mode développement. Il est donc important de conserver la valeur contenue dans target, puis de la restaurer avant de publier votre extension.

Créez et chargez votre extension

Ensuite, générez et chargez la version test de votre extension dans Windows Admin Center. Ouvrez une fenêtre de commande, remplacez le répertoire par votre répertoire source, puis vous êtes prêt à générer.

  • Générer et servir avec gulp :

    gulp build
gulp serve --port 4201

Notez que vous devez choisir un port actuellement gratuit. Veillez à ne pas essayer d’utiliser le port sur lequel Windows Admin Center s’exécute.

La version test de votre projet peut être chargée dans une instance locale de Windows Admin Center à des fins de test en attachant le projet servi localement à Windows Admin Center.

  • Lancer Windows Admin Center dans un navigateur web

  • Ouvrir le débogueur (F12)

  • Ouvrez la console et tapez la commande suivante :

    MsftSme.sideLoad("http://localhost:4201")

  • Actualiser le navigateur web

Votre projet est désormais visible dans la liste Outils avec (la version test chargée) en regard du nom.