Update-Package (konsola Menedżer pakietów w programie Visual Studio)

  • Artykuł

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:
  • Najniższa (domyślna ): najniższa wersja
  • Najwyższapatch: wersja z najniższym głównym, najniższym mniejszą poprawką pomocniczą, najwyższą poprawką
  • HighestMinor: wersja o najniższym numerze głównym, najwyższa wersja pomocnicza, najwyższa poprawka
  • Najwyższy (wartość domyślna dla pakietu Update-Package bez parametrów): najwyższa wersja
Wartość domyślną można ustawić przy użyciu 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