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 | 使用する依存関係パッケージのバージョンであり、次のいずれかになります。
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