Installer un gestionnaire de paquets pour PowerShell

Si vous utilisez PowerShell 6.0 ou une version ultérieure, vous avez déjà une version plus récente de PowerShellGet et PackageManagement installés. Vous devez vous assurer d’utiliser les dernières versions de ces modules.

Si vous utilisez PowerShell 7.4 ou une version ultérieure, vous avez aussi installé Microsoft.PowerShell.PSResourceGet (SourceShell). Microsoft.PowerShell.PSResourceGet est la nouvelle solution de gestion de paquets pour PowerShell. Avec ce module, vous n’avez plus besoin d’utiliser PowerShellGet et PackageManagement. Il est installé parallèlement aux modules PowerShellGet et PackageManagement existants.

Windows PowerShell est livré avec la version 1.0.0.1 de PowerShellGet et PackageManagement. Si vous utilisez Windows PowerShell 5.1, vous devez passer à la dernière version de PowerShellGet et PackageManagement. Toutes les versions de PowerShellGet v1.x ne sont plus prises en charge.

Utilisez les instructions suivantes pour installer ou mettre à jour les dernières versions de ces modules.

Étape 1 : Activer TLS 1.2

Pour accéder à la galerie PowerShell, vous devez utiliser Transport Layer Security (TLS) 1.2 ou une version supé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.

Étape 2 : Vérifiez les versions installées

Pour vérifier les versions actuellement installées des modules, exécutez la commande suivante :

$Names = @('PowerShellGet', 'PackageManagement', 'Microsoft.PowerShell.PSResourceGet')
Get-Module -Name $Names -ListAvailable

Dans Windows PowerShell 5.1 sur un système Windows nouvellement installé, vous devriez obtenir la sortie suivante :

    Directory: C:\Program Files\WindowsPowerShell\Modules


ModuleType Version  Name               ExportedCommands
---------- -------  ----               ----------------
Binary     1.0.0.1  PackageManagement  {Find-Package, Get-Package, ...
Script     1.0.0.1  PowerShellGet      {Install-Module, Find-Module, ...

Si la version de PowerShellGet est plus récente que 1.0.0.1 cela, vous pouvez vérifier les mises à jour et installer la dernière version.

Si vous utilisez encore la version 1.0.0.1, vous devez suivre les étapes pour permettre à PowerShellGet d’installer un fournisseur NuGet mis à jour ainsi que l’outil nuget.exe en ligne de commande. Passez à l’étape suivante.

Étape 3 : Vérifier les mises à jour

Pour vérifier les dernières versions des modules disponibles dans la galerie PowerShell, exécutez la commande suivante :

$Names = @('PowerShellGet', 'PackageManagement', 'Microsoft.PowerShell.PSResourceGet')
Find-Module -Name $Names -Repository PSGallery

Vous devriez obtenir un résultat similaire à celui suivant :

Version   Name                                Repository   Description
-------   ----                                ----------   -----------
1.4.8.1   PackageManagement                   PSGallery    PackageManagement (a.k.a. OneGet) is a n…
2.2.5     PowerShellGet                       PSGallery    PowerShell module with commands for disc…
1.1.1     Microsoft.PowerShell.PSResourceGet  PSGallery    PowerShell module with commands for disc…

Étape 4 : Mettre à jour les composants NuGet (si nécessaire)

Un fournisseur NuGet mis à jour est requis par les commandes PowerShellGet pour fonctionner avec la galerie PowerShell. Les Publish-* commandes utilisent nuget.exe ou dotnet.exe publient des ressources. Si aucun des deux outils n’est disponible, PowerShellGet installe nuget.exe. Si vous utilisez encore une version 1.0.0.1 de PowerShellGet, Find-Module il vous invite à installer le fournisseur NuGet. Entrez 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\PackageMan
agement\ProviderAssemblies' or 'C:\Users\user1\AppData\Local\PackageManagement\ProviderAs
semblies'. You can also install the NuGet provider by running 'Install-PackageProvider -N
ame NuGet -MinimumVersion 2.8.5.201 -Force'. Do you want PowerShellGet to install and imp
ort the NuGet provider now?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): Y
VERBOSE: Installing NuGet provider.

Lorsque vous répondez à Y, PowerShellGet installe le fournisseur NuGet et l’outil nuget.exe en ligne de commande (si nécessaire).

Étape 5 : Installer la dernière version

Pour installer les dernières versions de ces modules, exécutez les éléments suivants :

Install-Module PowerShellGet -Repository PSGallery -Force -AllowClobber
Install-Module Microsoft.PowerShell.PSResourceGet -Repository PSGallery

Note

Lorsque vous installez PowerShellGet, il installe automatiquement la dernière version de PackageManagement.