Windows 上の Visual Studio の NuGet パッケージ マネージャー コンソール内でのみ使用できます。
パッケージとその依存関係、またはプロジェクト内のすべてのパッケージを新しいバージョンに更新します。
構文
Update-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [-Version <string>]
[-Safe] [-Source <string>] [-IncludePrerelease] [-Reinstall] [-FileConflictAction]
[-DependencyVersion] [-ToHighestPatch] [-ToHighestMinor] [-WhatIf] [<CommonParameters>]
NuGet 2.8 以降では、 Update-Package プロジェクト内の既存のパッケージをダウングレードするために使用できます。 例えば、Microsoft.AspNet.MVC 5.1.0-rc1 がインストールされている場合、次のコマンドによって 5.0.0 にダウングレードされます。
Update-Package Microsoft.AspNet.MVC -Version 5.0.0.
パラメーター
| パラメーター | 内容 |
|---|---|
| Id | 更新するパッケージの識別子 省略するとすべてのパッケージが更新されます。 -Id スイッチ自体は省略可能です。 |
| IgnoreDependencies | パッケージの依存関係の更新をスキップします。 |
| ProjectName | 更新するパッケージを含むプロジェクトの名前。既定ではすべてのプロジェクトです。 |
| バージョン | アップグレードに使用するバージョン 。デフォルトは最新バージョンです。 NuGet 3.0 以降では、バージョンのVALUEは、最低、最高、HighestMinor、または HighestPatch のいずれかである必要があります (-セーフ に相当)。 |
| Safe | 現在インストールされているパッケージと同じメジャー バージョンとマイナー バージョンのバージョンのみにアップグレードを制限します。 |
| ソース | 検索するパッケージ ソースの URL またはフォルダー パス。 ローカル フォルダーのパスは、絶対パスにすることができます。または、現在のフォルダーを基準にしています。 省略した場合は、Update-Packageは、現在選択しているパッケージ ソースを検索します。 |
| IncludePrerelease | 更新プログラムのプレリリース パッケージを含む。 |
| 再インストール | 現在インストールされているバージョンを使用する Resintalls パッケージ。 「パッケージの再インストールと更新」をご覧ください。 |
| FileConflictAction | プロジェクトが参照する既存のファイルを上書きまたは無視するように求められたときに実行するアクション。 指定できる値は、Overwrite、Ignore、None、OverwriteAll、IgnoreAll (3.0 以降) です。 |
| DependencyVersion | 使用する依存関係パッケージのバージョンであり、次のいずれかになります。
dependencyVersionファイル内のNuget.Config設定を使用して設定できます。 |
| ToHighestPatch | -Safeと同じです |
| ToHighestMinor | 現在インストールされているパッケージと同じメジャー バージョンのバージョンのみにアップグレードを制限します。 |
| WhatIf | 実際に更新を実行せずにコマンドを実行するとどうなるかを示します。 |
これらのパラメーターはいずれも、パイプライン入力またはワイルドカード文字を承諾しません。
共通パラメーター
Update-Packageは、Debug、Error Action、ErrorVariable、OutBuffer、OutVariable、PipelineVariable、Verbose、WarningAction、WarningVariable の一般的な PowerShell パラメーターをサポートしています。
例
# Updates all packages in every project of the solution
Update-Package
# Updates every package in the MvcApplication1 project
Update-Package -ProjectName MvcApplication1
# Updates the Elmah package in every project to the latest version
Update-Package Elmah
# Updates the Elmah package to version 1.1.0 in every project showing optional -Id usage
Update-Package -Id Elmah -Version 1.1.0
# Updates the Elmah package within the MvcApplication1 project to the highest "safe" version.
# For example, if Elmah version 1.0.0 of a package is installed, and versions 1.0.1, 1.0.2,
# and 1.1 are available in the feed, the -Safe parameter updates the package to 1.0.2 instead
# of 1.1 as it would otherwise.
Update-Package Elmah -ProjectName MvcApplication1 -Safe
# Reinstall the same version of the original package, but with the latest version of dependencies
# (subject to version constraints). If this command rolls a dependency back to an earlier version,
# use Update-Package <dependency_name> to reinstall that one dependency without affecting the
# dependent package.
Update-Package Elmah –reinstall
# Reinstall the Elmah package in just MyProject
Update-Package Elmah -ProjectName MyProject -reinstall
# Reinstall the same version of the original package without touching dependencies.
Update-Package Elmah –reinstall -ignoreDependencies