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: メジャーが最も低く、マイナーが最も高く、パッチが最も高いバージョン
  • Highest (パラメーターなしの Update-Package の既定値): 最高位のバージョン
デフォルト値は、dependencyVersionファイル内のNuget.Config設定を使用して設定できます。
WhatIf 実際にインストールを実行せずにコマンドを実行した場合に何が起こるかを示します。

これらのパラメーターはいずれも、パイプライン入力またはワイルドカード文字を承諾しません。

共通パラメーター

Install-Packageは、Debug、Error Action、ErrorVariable、OutBuffer、OutVariable、PipelineVariable、Verbose、WarningAction、WarningVariable の一般的な PowerShell パラメーターをサポートしています。

例

# 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