Install-Package (Console du Gestionnaire de package dans Visual Studio)

  • Article

Cette rubrique décrit la commande dans la console du Gestionnaire de package dans Visual Studio sous Windows. Pour en savoir plus sur la commande PowerShell Install-Package générique, consultez la référence sur PowerShell PackageManagement.

Installe le package et ses dépendances dans le projet.

Syntaxe

Install-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [[-Source] <string>] 
    [[-Version] <string>] [-IncludePrerelease] [-FileConflictAction] [-DependencyVersion]
    [-WhatIf] [<CommonParameters>]

Dans NuGet 2.8+, Install-Package peut passer à une version antérieure d’un package existant dans votre projet. Par exemple, si Microsoft.AspNet.MVC 5.1.0-rc1 est installé, la commande suivante permet de passer à une version antérieure, à savoir la version 5.0.0 :

Install-Package Microsoft.AspNet.MVC -Version 5.0.0.

Paramètres

Paramètre Description
ID (Obligatoire) identifiant du package à installer. (3.0+) L’identifiant peut être un chemin d’accès ou une URL de fichier packages.config ou de fichier .nupkg. Le commutateur -Id proprement dit est facultatif.
IgnoreDependencies Installez uniquement ce package, et non ses dépendances.
Nom du projet Projet dans lequel installer le package, en utilisant par défaut le projet par défaut.
Source URL ou chemin d’accès au dossier de la source du package à rechercher. Les chemins d’accès aux dossiers locaux peuvent être absolus ou relatifs au dossier actif. En cas d’omission, Install-Package recherche la source du package actuellement sélectionné.
Version Version du package à installer, par défaut la dernière version.
IncludePrerelease Prend en compte les packages de préversion pour l’installation. En cas d’omission, seuls les packages stables sont pris en compte.
FileConflictAction Action à entreprendre lorsqu’il est demandé de remplacer ou d’ignorer les fichiers existants référencés par le projet. Les valeurs possibles sont Overwrite (remplacer), Ignore (ignorer), None (néant), OverwriteAll (remplacer tout) et (3.0+)IgnoreAll (ignorer tout).
DependencyVersion Version des packages de dépendances à utiliser, qui peut être l’une des suivantes :
  • Lowest (valeur par défaut) : la version la plus basse
  • HighestPatch : la version avec la majeure la plus basse, la mineure la plus basse et le correctif le plus élevé
  • HighestMinor : la version avec la majeure la plus basse, la mineure la plus élevée et le correctif le plus élevé
  • Highest (valeur par défaut d’Update-Package sans paramètres) : la version la plus élevée
Vous pouvez définir la valeur par défaut à l’aide du réglage dependencyVersion dans le fichier Nuget.Config.
WhatIf Affiche ce qui se passerait lors de l’exécution de la commande sans effectuer réellement l’installation.

Aucun de ces paramètres n’accepte d’entrée de pipeline ou de caractères génériques.

Paramètres communs

Install-Package prend en charge les paramètres courants suivants : Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable et OutVariable.

Exemples

# Installs the latest version of Elmah from the current source into the default project
Install-Package Elmah

# Installs Glimpse 1.0.0 into the MvcApplication1 project
Install-Package Glimpse -Version 1.0.0 -Project MvcApplication1

# Installs Ninject.Mvc3 but not its dependencies from c:\temp\packages
Install-Package Ninject.Mvc3 -IgnoreDependencies -Source c:\temp\packages

# Installs the package listed on the online packages.config into the current project
# Note: the URL must end with "packages.config"
Install-Package https://raw.githubusercontent.com/linked-data-dotnet/json-ld.net/master/.nuget/packages.config

# Installs jquery 1.10.2 package, using the .nupkg file under local path of c:\temp\packages
Install-Package c:\temp\packages\jQuery.1.10.2.nupkg

# Installs the specific online package
# Note: the URL must end with ".nupkg"
Install-Package https://globalcdn.nuget.org/packages/microsoft.aspnet.mvc.5.2.3.nupkg