Développer une extension de solution

  • Article

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 Admin Center. Ces solutions/types de connexion sont inclus dans Windows Admin Center par défaut :

  • Connexions Windows Server
  • Connexions PC Windows
  • Connexions de cluster de basculement
  • Connexions de cluster hyperconvergées

Lorsque vous sélectionnez une connexion dans la page de connexion Windows Admin Center, l’extension de solution pour le type de connexion est chargée et Windows Admin Center tente de se connecter au nœud cible. Si la connexion réussit, l’interface utilisateur de l’extension de solution se charge et Windows Admin Center affiche les outils de cette solution dans le volet de navigation gauche.

Si vous souhaitez créer une interface graphique utilisateur de gestion pour les services qui ne sont pas définis par les types de connexion par défaut ci-dessus, comme un commutateur réseau ou tout autre matériel non détectable par nom d’ordinateur, vous pouvez créer votre propre extension de 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 de solution avec le Kit de développement logiciel (SDK) Windows Admin Center

Une fois toutes les dépendances installées, vous êtes prêt à créer votre extension de solution. Créez ou accédez à un dossier qui contient vos fichiers 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) Windows Admin Center qui a été installé précédemment, créez une extension avec la syntaxe suivante :

wac create --company "{!Company Name}" --solution "{!Solution Name}" --tool "{!Tool Name}" --version latest
Valeur Explication Exemple
{!Company Name} Nom de votre entreprise (avec espaces) Contoso Inc
{!Solution Name} Nom de votre solution (avec espaces) Contoso Foo Works Suite
{!Tool Name} Nom de votre outil (avec 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 dossier à l’intérieur du répertoire de travail actuel en utilisant le nom que vous avez spécifié pour votre solution, copie tous les fichiers de modèles nécessaires dans votre projet et configure les fichiers avec le nom de votre entreprise, de la solution 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.

Générer et charger la version test de 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.