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 Версия используемых пакетов зависимостей, которая может быть одной из следующих:
  • Самый низкий (по умолчанию): самая низкая версия
  • HighestPatch: версия с наименьшим основным, наименьшим дополнительным, самым высоким исправлением
  • Самый высокий Минор: версия с самым низким основным, самым высоким дополнительным, самым высоким исправлением
  • Самый высокий (по умолчанию для update-Package без параметров): самая высокая версия
Значение по умолчанию можно задать с помощью 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