Partager via

Installer et gérer des extensions

  • S’applique à: ✅ Windows Admin Center, ✅ Windows Admin Center Preview

Windows Admin Center est construit comme une plateforme extensible où chaque type de connexion et chaque outil est une extension que vous pouvez installer, désinstaller et mettre à jour individuellement. Vous pouvez rechercher de nouvelles extensions publiées par Microsoft et d’autres développeurs, les installer et les mettre à jour individuellement sans avoir à mettre à jour l’ensemble de l’installation Windows Admin Center. Vous pouvez également configurer un partage de fichiers ou un flux NuGet distinct, et distribuer les extensions à utiliser en interne au sein de votre organisation.

Installation d’une extension

Windows Admin Center indique les extensions disponibles à partir du flux NuGet spécifié. Par défaut, Windows Admin Center pointe vers le flux NuGet officiel de Microsoft qui héberge les extensions publiées par Microsoft et d’autres développeurs.

  1. Sélectionnez le bouton Paramètres en haut à droite > dans le volet gauche, puis sélectionnez Extensions.
  2. L’onglet Extensions disponibles répertorie les extensions du flux qui sont disponibles pour l’installation.
  3. Sélectionnez une extension pour afficher la description de l’extension, la version, l’éditeur et d’autres informations dans le volet Détails .
  4. Sélectionnez Installer pour installer une extension. Si la passerelle doit s’exécuter avec élévation de privilèges pour effectuer cette modification, une invite d’élévation du contrôle de compte d’utilisateur vous est présentée. Une fois l’installation terminée, votre navigateur est automatiquement actualisé et Windows Admin Center est rechargé avec la nouvelle extension installée. Si l’extension que vous essayez d’installer est une mise à jour vers une extension précédemment installée, vous pouvez sélectionner le bouton Mettre à jour vers la dernière version pour installer la mise à jour. Vous pouvez également accéder à l’onglet Extensions installées pour afficher les extensions installées et voir si une mise à jour est disponible dans la colonne État .

Installation des extensions à partir d’un autre flux

Windows Admin Center prend en charge plusieurs flux et vous pouvez afficher et gérer des packages à partir de plusieurs flux à la fois. Tout flux NuGet prenant en charge les API NuGet V2 ou un partage de fichiers peut être ajouté dans Windows Admin Center comme source d’installation d’extensions.

  1. Sélectionnez le bouton Paramètres en haut à droite > dans le volet gauche, puis sélectionnez Extensions.
  2. Dans le volet droit, sélectionnez l’onglet Flux .
  3. Sélectionnez le bouton Ajouter pour ajouter un autre flux. Pour un flux NuGet, entrez l’URL du flux NuGet V2. L’administrateur ou le fournisseur de flux NuGet doit être en mesure de fournir les informations d’URL. Pour un partage de fichiers, entrez le chemin complet du partage de fichiers dans lequel les fichiers de package d’extension (.nupkg) sont stockés. Si vous ajoutez un partage de fichiers en tant que flux, il doit répondre aux critères suivants :
  4. Sélectionnez Ajouter. Si la passerelle doit s’exécuter avec élévation de privilèges pour effectuer cette modification, une invite d’élévation du contrôle de compte d’utilisateur vous est présentée. Cette invite s’affiche uniquement si vous exécutez Windows Admin Center en mode Bureau.

La liste Extensions disponibles affiche les extensions de tous les flux inscrits. Vous pouvez vérifier le flux à partir duquel chaque extension provient de la colonne Flux de package .

Désinstallation d’une extension

Vous pouvez désinstaller toutes les extensions que vous avez installées précédemment, voire désinstaller les outils préinstallés dans le cadre de l’installation de Windows Admin Center.

  1. Sélectionnez le bouton Paramètres en haut à droite > dans le volet gauche, puis sélectionnez Extensions.
  2. Sélectionnez l’onglet Extensions installées pour afficher toutes les extensions installées.
  3. Choisissez une extension à désinstaller, puis sélectionnez Désinstaller.

Une fois la désinstallation terminée, votre navigateur est automatiquement actualisé et Windows Admin Center est rechargé avec l’extension supprimée. Si vous avez désinstallé un outil préinstallé dans le cadre de Windows Admin Center, l’outil est disponible pour la réinstallation sous l’onglet Extensions disponibles .

Installation d’extensions sur un ordinateur sans connexion Internet

Si Windows Admin Center est installé sur un ordinateur qui n’est pas connecté à Internet ou qui se trouve derrière un proxy, il est possible qu’il ne puisse pas accéder aux extensions ni les installer à partir du flux Windows Admin Center. Vous pouvez télécharger des packages d’extension manuellement ou à l’aide d’un script PowerShell, et configurer Windows Admin Center pour récupérer les packages à partir d’un partage de fichiers ou d’un lecteur local.

Téléchargement manuel des packages d’extension

  1. Sur un autre ordinateur disposant d’une connectivité Internet, ouvrez un navigateur web et accédez à l’URL suivante :https://dev.azure.com/WindowsAdminCenter/Windows%20Admin%20Center%20Feed/_packaging?_a=feed& feed=WAC

    Vous devrez peut-être créer un compte Microsoft et vous connecter pour afficher les packages d’extension.

  2. Sélectionnez le nom du package que vous souhaitez installer pour afficher la page des détails du package.

  3. Sélectionnez le lien Télécharger dans la barre de navigation supérieure de la page détails du package et téléchargez le .nupkg fichier de l’extension.

  4. Répétez les étapes 2 et 3 pour tous les packages que vous souhaitez télécharger.

  5. Copiez les fichiers de package dans un partage de fichiers accessible depuis l’ordinateur où Windows Admin Center est installé, ou sur le disque local de l’ordinateur où Windows Admin Center est installé.

  6. Suivez ces instructions pour installer des extensions à partir d’un flux différent.

Téléchargement de packages à l’aide d’un script PowerShell

Il existe des scripts disponibles sur Internet pour télécharger des packages NuGet à partir d’un flux NuGet. Nous utilisons le script fourni par Jon Galloway, responsable de programme senior chez Microsoft.

  1. Comme décrit dans le billet de blog, installez le script en tant que package NuGet, ou copiez et collez le script dans PowerShell ISE.

  2. Modifiez la première ligne du script avec l’URL v2 de votre flux NuGet. Si vous téléchargez des packages à partir du flux officiel Windows Admin Center, utilisez l’URL suivante :

    $feedUrlBase = "https://aka.ms/sme-extension-feed"

  3. Exécutez le script pour télécharger tous les packages NuGet du flux dans le dossier local suivant : %USERPROFILE%\Documents\NuGetLocal

  4. Suivez ces instructions pour installer des extensions à partir d’un flux différent.

Gérer les extensions avec PowerShell

La préversion de Windows Admin Center comprend un module PowerShell pour gérer vos extensions de passerelle.

# Add the module to the current session
Import-Module "$env:ProgramFiles\windows admin center\PowerShell\Modules\ExtensionTools"
# Available cmdlets: Get-Feed, Add-Feed, Remove-Feed, Get-Extension, Install-Extension, Uninstall-Extension, Update-Extension

# List feeds
Get-Feed "https://wac.contoso.com"

# Add a new extension feed
Add-Feed -GatewayEndpoint "https://wac.contoso.com" -Feed "\\WAC\our-private-extensions"

# Remove an extension feed
Remove-Feed -GatewayEndpoint "https://wac.contoso.com" -Feed "\\WAC\our-private-extensions"

# List all extensions
Get-Extension "https://wac.contoso.com"

# Install an extension (locate the latest version from all feeds and install it)
Install-Extension -GatewayEndpoint "https://wac.contoso.com" "msft.sme.containers"

# Install an extension (latest version from a specific feed, if the feed is not present, it will be added)
Install-Extension -GatewayEndpoint "https://wac.contoso.com" "msft.sme.containers" -Feed "https://aka.ms/sme-extension-feed"

# Install an extension (install a specific version)
Install-Extension "https://wac.contoso.com" "msft.sme.certificate-manager" "0.133.0"

# Uninstall-Extension
Uninstall-Extension "https://wac.contoso.com" "msft.sme.containers"

# Update-Extension
Update-Extension "https://wac.contoso.com" "msft.sme.containers"

Note

Vous devez être administrateur de passerelle pour pouvoir modifier les extensions Windows Admin Center avec PowerShell.

En savoir plus sur la création d’une extension avec le kit SDK Windows Admin Center.

Extensions de plug-in de passerelle

Les extensions de plug-in de passerelle Windows Admin Center sont les plus affectées par les modifications apportées à notre passerelle modernisée. Les plug-ins de passerelle Windows Admin Center permettent la communication d’API à partir de l’interface utilisateur de votre outil ou solution vers un nœud cible. Windows Admin Center héberge un service de passerelle qui relaye les commandes et les scripts des plug-ins de passerelle à exécuter sur les nœuds cibles. Le service de passerelle peut être étendu pour inclure des plug-ins de passerelle personnalisés qui prennent en charge les protocoles autres que ceux par défaut (PowerShell et WMI).

Étant donné que les plug-ins de passerelle communiquent avec le serveur principal de Windows Admin Center pour activer la communication d’API, le code de plug-in de passerelle peut inclure des composants écrits avec le .NET Framework version 4.6.2, qui ne fonctionne pas avec .NET 8.

En outre, nous avons modifié la façon dont les plug-ins fonctionnent avec la version 2410. Au lieu de développer une classe C# qui implémente l’interface IPlugIn à partir de l’espace Microsoft.ManagementExperience.FeatureInterfaces de noms pour étendre le plug-in de passerelle, les extensions seront désormais écrites sous la forme de contrôleurs MVC ASP.NET. Ces contrôleurs ont augmenté la flexibilité par rapport à la classe C# simple et à une documentation complète.

Consultez notre documentation pour les développeurs pour en savoir plus sur le développement de plug-ins de passerelle dans Windows Admin Center.

Extensions de passerelle non prises en charge

Le flux d’extension de la passerelle Windows Admin Center n’est pas configuré. Les extensions non incluses dans le programme d’installation de Windows Admin Center, y compris les extensions de partenaire externe, ne sont pas disponibles, sauf si vous ajoutez un flux d’extension.

Les extensions suivantes sont disponibles lors de l’installation de la build de passerelle modernisée :

  • Applications et fonctionnalités
  • Sauvegarde Azure
  • Azure File Sync
  • Centre hybride Azure
  • Azure Kubernetes Service
  • Certificates
  • Création de cluster
  • Gestionnaire de cluster
  • Guide du développeur
  • Dispositifs
  • Épreuves
  • Outils de cluster de basculement
  • Partage de fichiers & fichiers
  • Pare-feu
  • Utilisateurs locaux et groupes
  • Outils de contrôleur de réseau et réseaux virtuels SDN
  • Réseau
  • Surveillance des paquets
  • Analyseur de performances
  • PowerShell
  • Processes
  • Registry
  • Bureau à distance
  • Rôles et fonctionnalités
  • Tâches planifiées
  • Connexions de passerelle SDN
  • SDN Infrastructure
  • Réseaux logiques SDN
  • Groupes de sécurité réseau SDN
  • Security
  • Gestionnaire de serveur et gestion des ordinateurs
  • Services
  • Storage
  • Service de migration de stockage
  • Réplica de stockage
  • System Insights
  • Mises à jour
  • Machines virtuelles et commutateurs
  • Last updated on