Visual Studio) 中的 Install-Package (封裝管理員主控台

本主題說明 Windows 中 Visual Studio 的封裝管理員主控台內的命令。 如需一般 PowerShell Install-Package 命令,請參閱 PowerShell PackageManagement 參考

將封裝及其相依性安裝到專案中。

Syntax

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

在 NuGet 2.8 + 中, Install-Package 可以在您的專案中降級現有的封裝。 例如,如果您已安裝 5.1.0 rc1,則下列命令會將它降級為5.0.0:

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

參數

參數 描述
識別碼 (需要) 要安裝的封裝識別碼。 (3.0 +) 識別碼可以是檔案或 .nupkg 檔案的路徑或 URL packages.config 。 -Id 參數本身是選擇性的。
IgnoreDependencies 只安裝此套件,而不安裝其相依性。
ProjectName 要在其中安裝封裝的專案,預設為預設專案。
來源 要搜尋之套件來源的 URL 或資料夾路徑。 本機資料夾路徑可以是絕對或相對於目前資料夾的路徑。 如果省略, Install-Package 則會搜尋目前選取的封裝來源。
版本 要安裝的套件版本,預設為最新版本。
IncludePrerelease 考慮安裝的發行前版本套件。 若省略此步驟,則系統只會考慮穩定的封裝。
FileConflictAction 當系統要求覆寫或忽略專案所參考的現有檔案時,所要採取的動作。 可能的值為覆寫、忽略、無、OverwriteAll (3.0 +) IgnoreAll
DependencyVersion 要使用之相依性套件的版本,它可以是下列其中一項:
  • 最低 (預設) :最低版本
  • HighestPatch:最低主要、最低次要、最高修補程式的版本
  • HighestMinor:最低主要、最小次要、最高修補程式的版本
  • 不含參數的 Update-Package最高 (預設值) :最高版本
您可以使用檔案中 Nuget.ConfigdependencyVersion 設定來設定預設值。
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