Téléchargement manuel de packageManual Package Download

PowerShell Gallery permet de télécharger un package directement à partir du site web, sans utiliser les applets de commande PowerShellGet.The PowerShell Gallery supports downloading a package from the website directly, without using the PowerShellGet cmdlets. 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.You can download any package as a NuGet package (.nupkg) file, which you can then copy to an internal repository.

Notes

Le téléchargement manuel de package n’est pas censé se substituer à l’applet de commande Install-Module.Manual package download is not intended as a replacement for the Install-Module cmdlet. Le téléchargement du package n’installe pas le module ou le script.Downloading the package doesn't install the module or script. Les dépendances ne sont pas incluses dans le package NuGet téléchargé.Dependencies aren't included in the NuGet package downloaded. Les instructions suivantes sont fournies à titre de référence uniquement.The following instructions are provided for reference purposes only.

Utilisation du téléchargement manuel pour obtenir un packageUsing manual download to acquire a package

Chaque page comporte un lien Téléchargement manuel, comme illustré ici :Each page has a link for Manual Download, as shown here:

Téléchargement manuel

Pour télécharger manuellement, cliquez sur Télécharger le fichier nupkg brut.To download manually, click on Download the raw nupkg file. Une copie du package est copiée dans le dossier de téléchargement de votre navigateur sous le nom <name>.<version>.nupkg.A copy of the package is copied to the download folder for your browser with the name <name>.<version>.nupkg.

Un package NuGet est une archive ZIP composée de fichiers supplémentaires contenant des informations sur le contenu du package.A NuGet package is a ZIP archive with extra files containing information about the contents of the package. Certains navigateurs, comme Internet Explorer, remplacent automatiquement l’extension de fichier .nupkg par .zip.Some browsers, like Internet Explorer, automatically replace the .nupkg file extension with .zip. Pour développer le package, renommez le fichier .nupkg en .zip, si nécessaire, puis extrayez le contenu dans un dossier local.To expand the package, rename the .nupkg file to .zip, if needed, then extract the contents to a local folder.

Un fichier de package NuGet comprend les éléments spécifiques NuGet suivants qui ne font pas partie du code empaqueté d’origine :A NuGet package file includes the following NuGet-specific elements that aren't part of the original packaged code:

  • Un dossier nommé _rels contenant un fichier .rels qui répertorie les dépendancesA folder named _rels - contains a .rels file that lists the dependencies
  • Un dossier nommé package contenant les données spécifiques NuGetA folder named package - contains the NuGet-specific data
  • Un fichier nommé [Content_Types].xml décrivant la façon dont les extensions comme PowerShellGet fonctionnent avec NuGetA file named [Content_Types].xml - describes how extensions like PowerShellGet work with NuGet
  • Un fichier nommé <name>.nuspec contenant la majeure partie des métadonnéesA file named <name>.nuspec - contains the bulk of the metadata

Installation de modules PowerShell à partir d’un package NuGetInstalling PowerShell modules from a NuGet package

Notes

Ces instructions NE donnent PAS les mêmes résultats qu’une exécution de Install-Module.These instructions DO NOT give the same result as running Install-Module. Ces instructions répondent aux exigences minimales.These instructions fulfill the minimum requirements. Elles ne sont pas destinées à se substituer à Install-Module.They aren't intended to be a replacement for Install-Module. Certaines étapes effectuées par Install-Module ne sont pas incluses.Some steps performed by Install-Module aren't included.

L’approche la plus simple consiste à supprimer les éléments spécifiques NuGet du dossier.The easiest approach is to remove the NuGet-specific elements from the folder. Avec la suppression des éléments, le code PowerShell créé par l’auteur du package est conservé.Removing the elements leaves the PowerShell code created by the package author. Pour obtenir la liste des éléments spécifiques NuGet, consultez Utilisation du téléchargement manuel pour acquérir un package.For the list of NuGet-specific elements, see Using manual download to acquire a package.

La procédure comporte trois étapes :The steps are as follows:

  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.Unblock the Internet-downloaded NuGet package (.nupkg) file, for example using Unblock-File -Path C:\Downloads\module.nupkg cmdlet.
  2. Extrayez le contenu du package NuGet dans un dossier local.Extract the contents of the NuGet package to a local folder.
  3. Supprimez les éléments spécifiques NuGet du dossier.Delete the NuGet-specific elements from the folder.
  4. Renommez le dossier.Rename the folder. Le nom de dossier par défaut est généralement <name>.<version>.The default folder name is usually <name>.<version>. La version peut inclure -prerelease si le module est marqué comme étant une version préliminaire.The version can include -prerelease if the module is tagged as a prerelease version. Renommez le dossier en conservant uniquement le nom du module.Rename the folder to just the module name. Par exemple, azurerm.storage.5.0.4-preview devient azurerm.storage.For example, azurerm.storage.5.0.4-preview becomes azurerm.storage.
  5. Copiez le dossier dans l’un des dossiers dans $env:PSModulePath value.Copy the folder to one of the folders in the $env:PSModulePath value. $env:PSModulePath est un ensemble de chemins délimités par des points-virgules, où PowerShell doit rechercher les modules.$env:PSModulePath is a semicolon-delimited set of paths in which PowerShell should look for modules.

Important

Le téléchargement manuel n’inclut pas les dépendances nécessaires au module.The manual download doesn't include any dependencies required by the module. Si le package a des dépendances, elles doivent être installées sur le système pour permettre à ce module de fonctionner correctement.If the package has dependencies, they must be installed on the system for this module to work correctly. PowerShell Gallery affiche toutes les dépendances nécessaires au package.The PowerShell Gallery shows all dependencies required by the package.

Installation de scripts PowerShell à partir d’un package NuGetInstalling PowerShell scripts from a NuGet package

Notes

Ces instructions NE donnent PAS les mêmes résultats qu’une exécution de Install-Script.These instructions DO NOT give the same result as running Install-Script. Ces instructions répondent aux exigences minimales.These instructions fulfill the minimum requirements. Elles ne sont pas destinées à se substituer à Install-Script.They aren't intended to be a replacement for Install-Script.

L’approche la plus simple consiste à extraire le package NuGet, puis à utiliser le script directement.The easiest approach is to extract the NuGet package, then use the script directly.

La procédure comporte trois étapes :The steps are as follows:

  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.Unblock the Internet-downloaded NuGet package (.nupkg) file, for example using Unblock-File -Path C:\Downloads\package.nupkg cmdlet.
  2. Extrayez le contenu du package NuGet.Extract the contents of the NuGet package.
  3. Le fichier .PS1 contenu dans le dossier peut être utilisé directement à partir de cet emplacement.The .PS1 file in the folder can be used directly from this location.
  4. Vous pouvez supprimer les éléments spécifiques NuGet du dossier.You may delete the NuGet-specific elements in the folder.

Pour obtenir la liste des éléments spécifiques NuGet, consultez Utilisation du téléchargement manuel pour acquérir un package.For the list of NuGet-specific elements, see Using manual download to acquire a package.

Important

Le téléchargement manuel n’inclut pas les dépendances nécessaires au module.The manual download doesn't include any dependencies required by the module. Si le package a des dépendances, elles doivent être installées sur le système pour permettre à ce module de fonctionner correctement.If the package has dependencies, they must be installed on the system for this module to work correctly. PowerShell Gallery affiche toutes les dépendances nécessaires au package.The PowerShell Gallery shows all dependencies required by the package.