Update-Package (консоль диспетчер пакетов в Visual Studio)
Доступно только в консоли NuGet диспетчер пакетов в Visual Studio в Windows.
Обновления пакет и его зависимости или все пакеты в проекте до более новой версии.
Синтаксис
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.0:
Update-Package Microsoft.AspNet.MVC -Version 5.0.0.
Параметры
Параметр | Описание |
---|---|
Артикул | Идентификатор пакета для обновления. Если опущено, обновляет все пакеты. Сам параметр -Id является необязательным. |
IgnoreDependencies | Пропускает обновление зависимостей пакета. |
Имя проекта | Имя проекта, содержащего пакеты для обновления, по умолчанию для всех проектов. |
Версия | Версия, используемая для обновления, по умолчанию используется последняя версия. В NuGet 3.0+ значение версии должно быть одним из самых низких, самых высоких, самого высокого или самого высокого уровня (эквивалентно -Сейф). |
Safe | Ограничивает обновление только версий с той же основной и дополнительной версией, что и установленный в данный момент пакет. |
Оригинал | Путь к URL-адресу или папке для поиска источника пакета. Путь к локальной папке может быть абсолютным или относительным к текущей папке. Если опущено, Update-Package выполняется поиск выбранного в данный момент источника пакета. |
IncludePrerelease | Включает пакеты предварительной версии для обновлений. |
Переустановка | Пакеты с использованием установленных в настоящее время версий. Дополнительные сведения см. в разделе Ограничение версий для обновления. |
FileConflictAction | Действие, выполняемого при запросе перезаписать или игнорировать существующие файлы, на которые ссылается проект. Возможные значения: Overwrite, Ignore, None, OverwriteAll и IgnoreAll (3.0+). |
DependencyVersion | Версия используемых пакетов зависимостей, которая может быть одной из следующих:
dependencyVersion параметра в Nuget.Config файле. |
ToHighestPatch | эквивалентно -Сейф. |
ToHighestMinor | Ограничивает обновление только версий с той же основной версией, что и установленный в данный момент пакет. |
WhatIf | Показывает, что произойдет при выполнении команды без фактического выполнения обновления. |
Ни один из этих параметров не принимает входные или дикие символы конвейера карта.
Общие параметры
Update-Package
поддерживает следующие распространенные параметры PowerShell: отладка, действие ошибки, errorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction и WarningVariable.
Примеры
# 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