Partager via

Téléchargement manuel du package

  • Article

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

Note

Le téléchargement manuel du package n’est pas destiné à remplacer 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 uniquement à des fins de référence.

Utilisation du téléchargement manuel pour acquérir un package

Chaque page a un lien pour le téléchargement manuel, comme indiqué ici :

page d’affichage de package avec les 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 avec le nom <name>.<version>.nupkg.

Un package NuGet est une archive ZIP avec des 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 à l’aide de Expand-Archive ou d’un autre outil de fichier ZIP.

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

  • Un dossier nommé _rels - contient un fichier .rels qui répertorie les dépendances
  • Un dossier nommé package - contient les données spécifiques à NuGet
  • Un fichier nommé [Content_Types].xml - décrit comment les extensions comme PowerShellGet fonctionnent avec NuGet
  • Un fichier nommé <name>.nuspec - contient la majeure partie des métadonnées

Installation de modules PowerShell à partir d’un package NuGet

Note

Ces instructions NE PAS donner le même résultat que l’exécution de Install-Module. Ces instructions répondent aux exigences minimales. Ils ne sont pas destinés à remplacer 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. La suppression des éléments laisse le code PowerShell créé par l’auteur du package. Pour obtenir la liste des éléments spécifiques à NuGet, consultez Utilisation du téléchargement manuel pour acquérir un package.

Les étapes sont les suivantes :

  1. Débloquez le fichier de package NuGet téléchargé par Internet (.nupkg), par exemple à l’aide de l’applet de commande 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 du dossier par défaut est généralement <name>.<version>. La version peut inclure -prerelease si le module est marqué comme une version préliminaire. Renommez le dossier en nom de module uniquement. Par exemple, azurerm.storage.5.0.4-preview devient azurerm.storage.
  5. Copiez le dossier dans l’un des dossiers du $env:PSModulePath value. $env:PSModulePath est un ensemble de chemins délimités par des points-virgules dans lesquels PowerShell doit rechercher des modules.

Important

Le téléchargement manuel n’inclut aucune dépendance requise par le module. Si le package a des dépendances, il doit être installé sur le système pour que ce module fonctionne correctement. PowerShell Gallery affiche toutes les dépendances requises par le package.

Installation de scripts PowerShell à partir d’un package NuGet

Note

Ces instructions NE PAS donner le même résultat que l’exécution de Install-Script. Ces instructions répondent aux exigences minimales. Ils ne sont pas destinés à remplacer Install-Script.

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

Les étapes sont les suivantes :

  1. Débloquez le fichier de package NuGet téléchargé par Internet (.nupkg), par exemple à l’aide de l’applet de commande Unblock-File -Path C:\Downloads\package.nupkg.
  2. Extrayez le contenu du package NuGet.
  3. Le fichier .PS1 du dossier peut être utilisé directement à partir de cet emplacement.
  4. Vous pouvez supprimer les éléments spécifiques à NuGet dans le 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 aucune dépendance requise par le module. Si le package a des dépendances, il doit être installé sur le système pour que ce module fonctionne correctement. PowerShell Gallery affiche toutes les dépendances requises par le package.