Install-Package（Visual Studio 中的包管理器控制台）

  • 项目

本主题介绍适用于 Windows 的 Visual Studio 中包管理器控制台内的此命令。 有关通用 PowerShell Install-Package 命令的信息，请参阅 PowerShell PackageManagement 参考。

将包及其依赖项安装到项目中。

语法

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

在 NuGet 2.8 及以上版本中，Install-Package 可将项目中的现有包降级。 例如，如果已安装 Microsoft.AspNet.MVC 5.1.0-rc1，以下命令则会将它降级到 5.0.0：

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

参数

参数 说明
Id （必选）待安装包的标识符。 （3.0 及以上版本）此标识符可为 packages.config 文件或 .nupkg 文件的路径或 URL。 -Id 开关自身为可选。
IgnoreDependencies 仅安装此包，而不安装其依赖项。
ProjectName 要在其中安装包的项目，默认为默认项目。
Source 要搜索的包源的 URL 或文件夹路径。 本地文件夹路径可为绝对路径，也可为相对于当前文件夹的路径。 如果省略，Install-Package 则会搜索当前选择的包源。
版本 待安装包的版本，默认为最新版本。
IncludePrerelease 为此安装考虑预发行包。 如果省略，则仅考虑稳定包。
FileConflictAction 当系统要求覆盖或忽略项目所引用的现有文件时要执行的操作。 可能的值为 Overwrite、Ignore、None、OverwriteAll 和（3.0 及以上版本）IgnoreAll。
DependencyVersion 待使用依赖项包的版本，它可为以下版本之一：
  • Lowest（默认值）：最低版本
  • HighestPatch：具有最低主要、最低次要、最高修补程序的版本
  • HighestMinor：具有最低主要、最高次要、最高修补程序的版本
  • 最高（不带参数的 Update-Package 的对应默认值）：最高版本
可使用 Nuget.Config 文件中的 dependencyVersion 设置来设置默认值。
WhatIf 显示运行此命令而不实际执行安装时会出现什么情况。

这些参数均不接受管道输入或通配符字符。

通用参数

Install-Package 支持以下常见 PowerShell 参数：Debug、Error Action、ErrorVariable、OutBuffer、OutVariable、PipelineVariable、Verbose、WarningAction 和 WarningVariable。

示例

# 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