Update-Package (konsola Menedżer pakietów w programie Visual Studio)
Dostępne tylko w konsoli Menedżer pakietów NuGet w programie Visual Studio w systemie Windows.
Aktualizacje pakiet i jego zależności lub wszystkie pakiety w projekcie do nowszej wersji.
Składnia
Update-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [-Version <string>]
[-Safe] [-Source <string>] [-IncludePrerelease] [-Reinstall] [-FileConflictAction]
[-DependencyVersion] [-ToHighestPatch] [-ToHighestMinor] [-WhatIf] [<CommonParameters>]
W wersji NuGet 2.8 lub nowszej Update-Package można użyć do obniżenia poziomu istniejącego pakietu w projekcie. Jeśli na przykład masz zainstalowany program Microsoft.AspNet.MVC 5.1.0-rc1, następujące polecenie obniży jego wersję do wersji 5.0.0:
Update-Package Microsoft.AspNet.MVC -Version 5.0.0.
Parametry
| Parametr | Opis |
|---|---|
| Id | Identyfikator pakietu do zaktualizowania. Jeśli pominięto, aktualizuje wszystkie pakiety. Przełącznik -Id jest opcjonalny. |
| IgnoreDependencies | Pomija aktualizowanie zależności pakietu. |
| ProjectName | Nazwa projektu zawierającego pakiety do zaktualizowania, domyślnie do wszystkich projektów. |
| Wersja | Wersja, która ma być używana do uaktualnienia, domyślnie jest używana do najnowszej wersji. W programie NuGet 3.0 lub nowszym wartość wersji musi być jedną z wartości Najniższa, Najwyższa, Najwyższa, Najwyższa lub NajwyższaPatch (równoważna -Sejf). |
| Safe | Ogranicza uaktualnienia tylko do wersji z tą samą wersją główną i pomocniczą co aktualnie zainstalowany pakiet. |
| Źródło | Adres URL lub ścieżka folderu źródła pakietu do wyszukania. Ścieżki folderów lokalnych mogą być bezwzględne lub względem bieżącego folderu. Jeśli pominięto, Update-Package przeszukuje aktualnie wybrane źródło pakietu. |
| Uwzględnij wersję wstępną | Zawiera pakiety wersji wstępnej dla aktualizacji. |
| Ponownie zainstalować | Pakiety żywicy używające aktualnie zainstalowanych wersji. Zobacz Ponowne instalowanie i aktualizowanie pakietów. |
| FileConflictAction | Akcja do wykonania po wyświetleniu monitu o zastąpienie lub zignorowanie istniejących plików przywoływanych przez projekt. Możliwe wartości to Overwrite, Ignore, None, OverwriteAll i IgnoreAll (3.0+). |
| DependencyVersion | Wersja pakietów zależności do użycia, która może być jedną z następujących opcji:
dependencyVersion ustawienia w Nuget.Config pliku . |
| ToHighestPatch | odpowiednik -Sejf. |
| ToHighestMinor | Ogranicza uaktualnienia tylko do wersji z tą samą wersją główną co aktualnie zainstalowany pakiet. |
| Instrukcja WhatIf | Pokazuje, co się stanie podczas uruchamiania polecenia bez faktycznego wykonania aktualizacji. |
Żaden z tych parametrów nie akceptuje znaków wejściowych potoku lub symboli wieloznacznych.
Typowe parametry
Update-Package obsługuje następujące typowe parametry programu PowerShell: Debug, Error Action, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction i WarningVariable.
Przykłady
# 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