Install-Package (консоль диспетчер пакетов в Visual Studio)

В этом разделе описывается команда в консоли диспетчер пакетов в Visual Studio в Windows. Для универсальной команды PowerShell Install-Package см . справочник по PowerShell PackageManagement.

Устанавливает пакет и его зависимости в проект.

Синтаксис

Install-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [[-Source] <string>] 
    [[-Version] <string>] [-IncludePrerelease] [-FileConflictAction] [-DependencyVersion]
    [-WhatIf] [<CommonParameters>]

В NuGet 2.8 и более Install-Package поздних версий можно уменьшить существующий пакет в проекте. Например, если установлен Microsoft.AspNet.MVC 5.1.0-rc1, следующая команда будет понижена до 5.0.0.0:

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

Параметры

Параметр Описание
Артикул (обязательно) Идентификатор устанавливаемого пакета. (3.0+) Идентификатор может быть путем или URL-адресом packages.config файла или .nupkg файла. Сам параметр -Id является необязательным.
IgnoreDependencies Установите только этот пакет, а не его зависимости.
Имя проекта Проект, в который необходимо установить пакет, по умолчанию используется проект по умолчанию.
Исходный код Путь к URL-адресу или папке для поиска источника пакета. Путь к локальной папке может быть абсолютным или относительным к текущей папке. Если опущено, Install-Package выполняется поиск выбранного в данный момент источника пакета.
Версия Версия пакета для установки, по умолчанию используется последняя версия.
IncludePrerelease Рассматривает предварительные пакеты для установки. Если опущено, считаются только стабильные пакеты.
FileConflictAction Действие, выполняемого при запросе перезаписать или игнорировать существующие файлы, на которые ссылается проект. Возможные значения: Overwrite, Ignore, None, OverwriteAll и (3.0+) IgnoreAll.
DependencyVersion Версия используемых пакетов зависимостей, которая может быть одной из следующих:
  • Самый низкий (по умолчанию): самая низкая версия
  • HighestPatch: версия с наименьшим основным, наименьшим дополнительным, самым высоким исправлением
  • Самый высокий Минор: версия с самым низким основным, самым высоким дополнительным, самым высоким исправлением
  • Самый высокий (по умолчанию для update-Package без параметров): самая высокая версия
Значение по умолчанию можно задать с помощью dependencyVersion параметра в Nuget.Config файле.
WhatIf Показывает, что произойдет при выполнении команды, не выполняя установку.

Ни один из этих параметров не принимает входные или подстановочные знаки конвейера.

Общие параметры

Install-Package поддерживает следующие распространенные параметры PowerShell: отладка, действие ошибки, errorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction и WarningVariable.

Примеры

# Installs the latest version of Elmah from the current source into the default project
Install-Package Elmah

# Installs Glimpse 1.0.0 into the MvcApplication1 project
Install-Package Glimpse -Version 1.0.0 -Project MvcApplication1

# Installs Ninject.Mvc3 but not its dependencies from c:\temp\packages
Install-Package Ninject.Mvc3 -IgnoreDependencies -Source c:\temp\packages

# Installs the package listed on the online packages.config into the current project
# Note: the URL must end with "packages.config"
Install-Package https://raw.githubusercontent.com/linked-data-dotnet/json-ld.net/master/.nuget/packages.config

# Installs jquery 1.10.2 package, using the .nupkg file under local path of c:\temp\packages
Install-Package c:\temp\packages\jQuery.1.10.2.nupkg

# Installs the specific online package
# Note: the URL must end with ".nupkg"
Install-Package https://globalcdn.nuget.org/packages/microsoft.aspnet.mvc.5.2.3.nupkg