Update-Package (konsola menedżera pakietów w programie Visual Studio)Update-Package (Package Manager Console in Visual Studio)

Dostępne tylko w obrębie Konsola Menedżera pakietów NuGet w programie Visual Studio na Windows.Available only within the NuGet Package Manager Console in Visual Studio on Windows.

Aktualizuje pakiet i jego zależności lub wszystkich pakietów w projekcie do nowszej wersji.Updates a package and its dependencies, or all packages in a project, to a newer version.

SkładniaSyntax

Update-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [-Version <string>]
    [-Safe] [-Source <string>] [-IncludePrerelease] [-Reinstall] [-FileConflictAction]
    [-DependencyVersion] [-ToHighestPatch] [-ToHighestMinor] [-WhatIf] [<CommonParameters>]

W pakiecie NuGet 2.8 + Update-Package może służyć do obniżenia poziomu istniejący pakiet w projekcie.In NuGet 2.8+, Update-Package can be used to downgrade an existing package in your project. Na przykład w przypadku 5.1.0-rc1 Microsoft.AspNet.MVC zainstalowane następujące polecenie będzie obniżyć do 5.0.0:For example, if you have Microsoft.AspNet.MVC 5.1.0-rc1 installed, the following command would downgrade it to 5.0.0:

Update-Package Microsoft.AspNet.MVC -Version 5.0.0.

ParametryParameters

ParametrParameter OpisDescription
IdId Identyfikator pakiet do zaktualizowania.The identifier of the package to update. W przypadku pominięcia aktualizuje wszystkie pakiety.If omitted, updates all packages. — Identyfikator samym przełączniku jest opcjonalne.The -Id switch itself is optional.
IgnoreDependenciesIgnoreDependencies Pomija aktualizowanie zależności pakietów.Skips updating the package's dependencies.
ProjectNameProjectName Nazwa projektu zawierający pakiety do aktualizacji, przyjęto wartość domyślną dla wszystkich projektów.The name of the project containing the packages to update, defaulting to all projects.
WersjaVersion Wersja do użycia podczas uaktualniania, ustawiając domyślnie do najnowszej wersji.The version to use for the upgrade, defaulting to the latest version. Nuget 3.0 +, wartość wersji musi mieć jedną z najniższy, najwyższa, HighestMinor, lub HighestPatch (równoważne — bezpieczna).In NuGet 3.0+, the version value must be one of Lowest, Highest, HighestMinor, or HighestPatch (equivalent to -Safe).
BezpieczneSafe Ogranicza uaktualnienia do wersji tylko przy użyciu tej samej wersji głównych i pomocniczych, co obecnie zainstalowanego pakietu.Constrains upgrades to only versions with the same Major and Minor version as the currently installed package.
SourceSource Adres URL lub folder ścieżka do źródła pakietu do wyszukania.The URL or folder path for the package source to search. Ścieżki folderu lokalnego, może być ścieżką bezwzględną, lub względną do bieżącego folderu.Local folder paths can be absolute, or relative to the current folder. W przypadku pominięcia Update-Package przeszukuje źródło obecnie wybranego pakietu.If omitted, Update-Package searches the currently selected package source.
IncludePrereleaseIncludePrerelease Obejmuje pakiety w wersjach wstępnych dla aktualizacji.Includes prerelease packages for updates.
Zainstaluj ponownieReinstall Pakiety Resintalls przy użyciu ich obecnie zainstalowanej wersji.Resintalls packages using their currently installed versions. Zobacz ponowne zainstalowanie i aktualizowanie pakietów.See Reinstalling and updating packages.
FileConflictActionFileConflictAction Akcja do wykonania po wyświetleniu monitu o zastąpienie lub zignorować istniejące pliki przywoływanego przez projekt.The action to take when asked to overwrite or ignore existing files referenced by the project. Możliwe wartości to zastąpienia, Zignoruj, None, OverwriteAll, i IgnoreAll (3.0 i nowsze).Possible values are Overwrite, Ignore, None, OverwriteAll, and IgnoreAll (3.0+).
DependencyVersionDependencyVersion Wersja pakietów zależności do użycia, które może być jedną z następujących czynności:The version of the dependency packages to use, which can be one of the following:
  • Najniższy (ustawienie domyślne): Najniższa wersjaLowest (default): the lowest version
  • HighestPatch: wersja przy najniższe główne, najniższą pomocnicza, najwyższy poziom poprawkiHighestPatch: the version with the lowest major, lowest minor, highest patch
  • HighestMinor: wersji z najniższą główne, najwyższy pomocnicza, najwyższy poziom poprawkiHighestMinor: the version with the lowest major, highest minor, highest patch
  • Najwyższy (domyślnie dla pakietu aktualizacji bez parametrów): najwyższa wersjaHighest (default for Update-Package with no parameters): the highest version
Można ustawić przy użyciu wartości domyślnej dependencyVersion ustawienie w Nuget.Config pliku.You can set the default value using the dependencyVersion setting in the Nuget.Config file.
ToHighestPatchToHighestPatch wartość równoważna — bezpieczne.equivalent to -Safe.
ToHighestMinorToHighestMinor Ogranicza uaktualnień tylko wersje z taką samą wersję główną jako aktualnie zainstalowany pakiet.Constrains upgrades to only versions with the same Major version as the currently installed package.
WhatIfWhatIf Pokazuje, co się stanie, podczas uruchamiania polecenia bez rzeczywistego wykonania aktualizacji.Shows what would happen when running the command without actually performing the update.

Żaden z tych parametrów akceptuje znaków potoku danych wejściowych lub symbol wieloznaczny.None of these parameters accept pipeline input or wildcard characters.

Wspólne parametryCommon Parameters

Update-Package obsługuje następujące typowe parametry programu PowerShell: Debugowanie, akcja w przypadku błędu, ErrorVariable, OutBuffer, OutVariable, PipelineVariable pełne, WarningAction i WarningVariable.Update-Package supports the following common PowerShell parameters: Debug, Error Action, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction, and WarningVariable.

PrzykładyExamples

# 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