Installer et gérer des extensions

  • Article

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. Cliquez sur le bouton Paramètres en haut à droite. > Dans le volet de gauche, cliquez sur Extensions.
  2. L’onglet Extensions disponibles liste les extensions sur le flux qui sont disponibles pour l’installation.
  3. Cliquez sur une extension pour afficher sa description, sa version, son éditeur et d’autres informations dans le volet Détails.
  4. Cliquez sur Installer pour installer une extension. Si la passerelle doit s’exécuter en mode élevé pour effectuer cette modification, une invite d’élévation du contrôle de compte d’utilisateur s’affiche. 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 d’une extension précédemment installée, vous pouvez cliquer sur le bouton Update to latest (Mettre à jour vers la dernière) pour installer cette mise à jour. Vous pouvez également accéder à l’onglet Installed Extensions (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. Cliquez sur le bouton Paramètres en haut à droite. > Dans le volet de gauche, cliquez sur Extensions.
  2. Dans le volet droit, cliquez sur l’onglet Feeds (Flux).
  3. Cliquez sur le bouton Add (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.
  4. Cliquez sur Ajouter. Si la passerelle doit s’exécuter en mode élevé pour effectuer cette modification, une invite d’élévation du contrôle de compte d’utilisateur s’affiche. Cette invite vous est uniquement présentée si vous exécutez Windows Admin Center en mode bureau.

La liste Extensions disponibles affiche les extensions de tous les flux enregistrés. Vous pouvez vérifier le flux d’où provient chaque extension à l’aide de la colonne flux du package.

Désinstallation d’une extension

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

  1. Cliquez sur le bouton Paramètres en haut à droite. > Dans le volet de gauche, cliquez sur Extensions.
  2. Cliquez sur l’onglet Extensions installées pour afficher toutes les extensions installées.
  3. Choisissez une extension à désinstaller, puis cliquez sur 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 qui était préinstallé dans le cadre de Windows Admin Center, l’outil est disponible pour 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 connexion 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. Cliquez sur le nom du package que vous souhaitez installer pour afficher la page de détails du package.

  3. Cliquez sur le lien Télécharger dans la barre de navigation supérieure de la page de détails du package et téléchargez le fichier .nupkg pour 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

De nombreux scripts sont disponibles sur Internet pour le téléchargement des packages NuGet à partir d’un flux NuGet. Nous allons utiliser le script fourni par Jon Galloway, responsable de programme senior chez Microsoft.

  1. Comme le décrit son billet de blog, installez le script sous la forme d’un package NuGet ou effectuez un copier-coller du 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 ci-dessous.
$feedUrlBase = "https://aka.ms/sme-extension-feed"
  1. Exécutez le script pour télécharger tous les packages NuGet du flux dans le dossier local suivant :%USERPROFILE%\Documents\NuGetLocal
  2. 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"

Notes

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 de Windows Admin Center.