Install-Package (Console du Gestionnaire de package dans Visual Studio)
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 Remplacer, Ignorer, Aucun(e), Remplacer tout et (3.0+) Ignorer tout. |
| DependencyVersion | Version des packages de dépendances à utiliser, qui peut être l’une des suivantes :
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