Partager via

Téléchargement manuel de package

  • Article

PowerShell Gallery permet de télécharger un package directement à partir du site web, sans utiliser les applets de commande PowerShellGet. Vous pouvez télécharger n’importe quel package en tant que fichier de package NuGet (.nupkg), que vous pouvez ensuite copier vers un référentiel interne.

Notes

Le téléchargement manuel de package n’est pas censé se substituer à l’applet de commande Install-Module. Le téléchargement du package n’installe pas le module ou le script. Les dépendances ne sont pas incluses dans le package NuGet téléchargé. Les instructions suivantes sont fournies à titre de référence uniquement.

Utilisation du téléchargement manuel pour obtenir un package

Chaque page comporte un lien Téléchargement manuel, comme illustré ici :

Page de présentation du package avec des options d’installation

Pour télécharger manuellement, cliquez sur Télécharger le fichier nupkg brut. Une copie du package est copiée dans le dossier de téléchargement de votre navigateur sous le nom <name>.<version>.nupkg.

Un package NuGet est une archive ZIP composée de fichiers supplémentaires contenant des informations sur le contenu du package. Certains navigateurs, comme Internet Explorer, remplacent automatiquement l’extension de fichier .nupkg par .zip. Pour développer le package, renommez le fichier .nupkg en .zip, si nécessaire, puis extrayez le contenu dans un dossier local.

Un fichier de package NuGet comprend les éléments spécifiques NuGet suivants qui ne font pas partie du code empaqueté d’origine :

  • Un dossier nommé _rels contenant un fichier .rels qui répertorie les dépendances
  • Un dossier nommé package contenant les données spécifiques NuGet
  • Un fichier nommé [Content_Types].xml décrivant la façon dont les extensions comme PowerShellGet fonctionnent avec NuGet
  • Un fichier nommé <name>.nuspec contenant la majeure partie des métadonnées

Installation de modules PowerShell à partir d’un package NuGet

Notes

Ces instructions NE donnent PAS les mêmes résultats qu’une exécution de Install-Module. Ces instructions répondent aux exigences minimales. Elles ne sont pas destinées à se substituer à Install-Module. Certaines étapes effectuées par Install-Module ne sont pas incluses.

L’approche la plus simple consiste à supprimer les éléments spécifiques NuGet du dossier. Avec la suppression des éléments, le code PowerShell créé par l’auteur du package est conservé. Pour obtenir la liste des éléments spécifiques NuGet, consultez Utilisation du téléchargement manuel pour acquérir un package.

La procédure comporte trois étapes :

  1. Débloquez le fichier du package NuGet téléchargé par Internet (.nupkg), par exemple avec la cmdlet Unblock-File -Path C:\Downloads\module.nupkg.
  2. Extrayez le contenu du package NuGet dans un dossier local.
  3. Supprimez les éléments spécifiques NuGet du dossier.
  4. Renommez le dossier. Le nom de dossier par défaut est généralement <name>.<version>. La version peut inclure -prerelease si le module est marqué comme étant une version préliminaire. Renommez le dossier en conservant uniquement le nom du module. Par exemple, azurerm.storage.5.0.4-preview devient azurerm.storage.
  5. Copiez le dossier dans l’un des dossiers dans $env:PSModulePath value. $env:PSModulePath est un ensemble de chemins délimités par des points-virgules, où PowerShell doit rechercher les modules.

Important

Le téléchargement manuel n’inclut pas les dépendances nécessaires au module. Si le package a des dépendances, elles doivent être installées sur le système pour permettre à ce module de fonctionner correctement. PowerShell Gallery affiche toutes les dépendances nécessaires au package.

Installation de scripts PowerShell à partir d’un package NuGet

Notes

Ces instructions NE donnent PAS les mêmes résultats qu’une exécution de Install-Script. Ces instructions répondent aux exigences minimales. Elles ne sont pas destinées à se substituer à Install-Script.

L’approche la plus simple consiste à extraire le package NuGet, puis à utiliser le script directement.

La procédure comporte trois étapes :

  1. Débloquez le fichier du package NuGet téléchargé par Internet (.nupkg), par exemple avec la cmdlet Unblock-File -Path C:\Downloads\package.nupkg.
  2. Extrayez le contenu du package NuGet.
  3. Le fichier .PS1 contenu dans le dossier peut être utilisé directement à partir de cet emplacement.
  4. Vous pouvez supprimer les éléments spécifiques NuGet du dossier.

Pour obtenir la liste des éléments spécifiques NuGet, consultez Utilisation du téléchargement manuel pour acquérir un package.

Important

Le téléchargement manuel n’inclut pas les dépendances nécessaires au module. Si le package a des dépendances, elles doivent être installées sur le système pour permettre à ce module de fonctionner correctement. PowerShell Gallery affiche toutes les dépendances nécessaires au package.