Mettre à jour PowerShellGet pour Windows PowerShell 5.1

Windows PowerShell 5.1 est fourni avec la version 1.0.0.1 de PowerShellGet et packageManagement préinstallés. Cette version de PowerShellGet a des fonctionnalités limitées et doit être mise à jour pour fonctionner avec le PowerShell Gallery. Pour cette prise en charge, vous devez effectuer une mise à jour vers la dernière version.

Prérequis

  • PowerShellGet nécessite .NET Framework 4.5 ou ultérieur. Pour plus d'informations, voir Installation de .NET Framework pour les développeurs.

  • Pour accéder à PowerShell Gallery, vous devez utiliser le protocole TLS (Transport Layer Security) version 1.2 ou ultérieure. Utilisez la commande suivante pour activer TLS 1.2 dans votre session PowerShell.

    [Net.ServicePointManager]::SecurityProtocol =
        [Net.ServicePointManager]::SecurityProtocol -bor
        [Net.SecurityProtocolType]::Tls12
    

    Ajoutez cette commande à votre script de profil PowerShell pour vous assurer que TLS 1.2 est configuré pour chaque session PowerShell. Pour plus d'informations sur les profils, consultez about_Profiles.

Installation de la dernière version de PowerShellGet

Le module PowerShellGet inclut des applets de commande qui permettent d’installer et de mettre à jour des modules :

  • Install-Module installe la dernière version (autre qu’une préversion) d’un module.
  • Update-Module installe la dernière version (non préliminaire) d’un module s’il est plus récent que le module actuellement installé. Toutefois, cette applet de commande fonctionne uniquement si la version antérieure avait été installée avec Install-Module.

Pour mettre à jour le module préinstallé, vous devez utiliser Install-Module. Après avoir installé la nouvelle version à partir de PowerShell Gallery, vous pouvez utiliser Update-Module pour installer des versions plus récentes.

Windows PowerShell 5.1 est fourni avec PowerShellGet version 1.0.0.1, qui n’inclut pas le fournisseur NuGet. Le fournisseur est requis par PowerShellGet quand PowerShell Gallery est utilisé.

Notes

Les commandes suivantes doivent être utilisées à partir d’une session PowerShell avec élévation de privilèges. Cliquez avec le bouton droit sur l’icône PowerShell et choisissez Exécuter en tant qu’administrateur pour démarrer une session avec élévation de privilèges.

Il existe deux manières d’installer le fournisseur NuGet :

  • Utiliser Install-PackageProvider pour installer NuGet avant d’installer d’autres modules

    Exécutez la commande suivante pour installer le fournisseur NuGet.

    Install-PackageProvider -Name NuGet -Force
    

    Après avoir installé le fournisseur, vous pouvez normalement utiliser les applets de commande PowerShellGet dans PowerShell Gallery.

  • Laisser Install-Module vous inviter à installer le fournisseur NuGet

    La commande suivante tente d’installer le module PowerShellGet mis à jour sans le fournisseur NuGet.

    Install-Module PowerShellGet -AllowClobber -Force
    

    Install-Module vous invite à installer le fournisseur NuGet. Tapez Y pour installer le fournisseur.

    NuGet provider is required to continue
    PowerShellGet requires NuGet provider version '2.8.5.201' or newer to interact with NuGet-based
    repositories. The NuGet provider must be available in 'C:\Program Files\PackageManagement\ProviderAssemblies'
    or 'C:\Users\user1\AppData\Local\PackageManagement\ProviderAssemblies'. You can also install the
    NuGet provider by running 'Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force'.
    Do you want PowerShellGet to install and import the NuGet provider now?
    [Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y
    VERBOSE: Installing NuGet provider.
    

Après l’installation de PowerShellGet

Une fois que vous avez installé la nouvelle version de PowerShellGet, vous devez ouvrir une nouvelle session PowerShell. PowerShell charge automatiquement la version la plus récente du module lorsque vous utilisez une applet de commande PowerShellGet.

Nous vous recommandons également d’inscrire PowerShell Gallery comme référentiel approuvé. Utilisez la commande suivante :

Set-PSRepository -Name PSGallery -InstallationPolicy Trusted

Pour plus d’informations, consultez Set-PSRepository.