分享方式:


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 要安裝封裝的項目,預設為預設專案。
來源 要搜尋之套件來源的 URL 或資料夾路徑。 本機資料夾路徑可以是絕對路徑,或相對於目前資料夾。 如果省略, Install-Package 請搜尋目前選取的套件來源。
版本 要安裝的套件版本,預設為最新版本。
IncludePrerelease 請考慮安裝的發行前版本套件。 如果省略,只會考慮穩定套件。
FileConflictAction 要求覆寫或忽略專案所參考之現有檔案時要採取的動作。 可能的值為 Overwrite、Ignore、None、OverwriteAll(3.0+) IgnoreAll
DependencyVersion 要使用的相依性套件版本,可以是下列其中一項:
  • 最低 (預設值):最低版本
  • HighestPatch:具有最低主要、最低次要、最高修補程式的版本
  • HighestMinor:具有最低主要、最高次要、最高修補程式的版本
  • 最高 (不含參數的 Update-Package 預設值):最高版本
您可以使用 檔案中的 Nuget.Config 設定來設定預設值dependencyVersion
Whatif 顯示執行命令時會發生什麼情況,而不需要實際執行安裝。

這些參數都不接受管線輸入或通配符。

一般參數

Install-Package 支援下列 常見的 PowerShell 參數:D ebug、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