Partager via

Installer et gérer des extensions

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

Windows Admin Center est créé en tant que plateforme extensible où chaque type de connexion et 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 affiche 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 en mode avec élévation de privilèges pour effectuer cette modification, une invite d’élévation de contrôle de compte d’utilisateur (UAC) s’affiche. Une fois l’installation terminée, votre navigateur actualise automatiquement et Windows Admin Center recharge 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 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. 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 en mode avec élévation de privilèges pour effectuer cette modification, une invite d’élévation DAC 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 inscrits. 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 précédemment installées, ou même désinstaller tous les outils qui ont été 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 actualise automatiquement et Windows Admin Center recharge 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 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. 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 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 suivante :
$feedUrlBase = "https://aka.ms/sme-extension-feed"
  1. Exécutez le script et télécharge tous les packages NuGet à partir 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.