Développer une extension de solution

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

les Solutions définissent principalement un type unique d’objet que vous souhaitez gérer via Windows centre d’administration. ces solutions/types de connexion sont inclus avec Windows centre d’administration par défaut :

  • connexions Windows Server
  • connexions Windows PC
  • Connexions de cluster de basculement
  • Connexions de cluster hyper-convergé

lorsque vous sélectionnez une connexion dans la page Windows la connexion au centre d’administration, l’extension de solution pour ce type de connexion est chargée et Windows centre d’administration tente de se connecter au nœud cible. si la connexion réussit, l’interface utilisateur de l’extension de solution est chargée et Windows centre d’administration affiche les outils pour cette solution dans le volet de navigation gauche.

Si vous souhaitez créer une interface utilisateur graphique de gestion pour les services qui ne sont pas définis par les types de connexion par défaut ci-dessus, un commutateur réseau ou tout autre matériel non détectable par le nom de l’ordinateur, vous pouvez créer votre propre extension de solution.

Notes

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

Préparation de votre environnement

Si vous ne l’avez pas déjà fait, Préparez votre environnement en installant des dépendances et des prérequis globaux requis pour tous les projets.

créer une extension de solution avec le kit de développement logiciel (SDK) du centre d’administration Windows

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

wac create --company "{!Company Name}" --solution "{!Solution Name}" --tool "{!Tool Name}"
Valeur Explication Exemple
{!Company Name} Nom de votre société (avec des espaces) Contoso Inc
{!Solution Name} Le nom de votre solution (avec des espaces) Contoso Foo Works Suite
{!Tool Name} Votre nom d’outil (avec des espaces) Manage Foo Works

Voici un exemple d’utilisation :

wac create --company "Contoso Inc" --solution "Contoso Foo Works Suite" --tool "Manage Foo Works"

Cela crée un nouveau dossier dans le répertoire de travail actuel en utilisant le nom que vous avez spécifié pour votre solution, copie tous les fichiers de modèle nécessaires dans votre projet et configure les fichiers avec le nom de votre société, de votre solution et de votre outil.

Ensuite, accédez au 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 centre d’administration.

Ajouter du contenu à votre extension

maintenant que vous avez créé une extension avec le kit de développement logiciel (SDK) du centre d’administration Windows, vous êtes prêt à personnaliser le contenu. Pour obtenir des exemples de ce que vous pouvez faire, consultez les guides suivants :

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 dans Windows centre d’administration, 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 Guide du développeur sur la page avancé de vos paramètres Windows centre d’administration.

Créez et chargez votre extension

ensuite, créez et chargez votre extension dans Windows centre d’administration. Ouvrez une fenêtre de commande, accédez au répertoire source, puis vous êtes prêt à générer.

  • Créez et servez-vous de Gulp :

    gulp build
    gulp serve --port 4201
    

Notez que vous devez choisir un port qui est actuellement libre. vérifiez que vous n’essayez pas d’utiliser le port sur lequel Windows centre d’administration est en cours d’exécution.

votre projet peut être chargé dans une instance locale de Windows centre d’administration à des fins de test en joignant le projet desservi localement à Windows centre d’administration.

  • lancer Windows centre d’administration 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 sera désormais visible dans la liste des outils avec (chargé sur le côté) en regard du nom.

cibler une version différente du kit de développement logiciel (SDK) du centre d’administration Windows

Il est facile de tenir à jour votre extension avec les modifications du SDK et les modifications de la plateforme. en savoir plus sur la façon de cibler une version différente du kit de développement logiciel (SDK) du centre d’administration Windows.