Install-Package

Ссылка

Модуль:: PackageManagement

Устанавливает один или несколько пакетов программного обеспечения.

Синтаксис

Install-Package
       [-Name] <String[]>
       [-RequiredVersion <String>]
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-Source <String[]>]
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ProviderName <String[]>]
       [<CommonParameters>]

Install-Package
       [-InputObject] <SoftwareIdentity[]>
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]

Описание

Командлет Install-Package устанавливает один или несколько пакетов программного обеспечения на локальном компьютере. Если у вас несколько источников программного обеспечения, используйте Get-PackageProvider и Get-PackageSource отобразите сведения о поставщиках.

Это важно

Команды, содержащиеся в модуле PackageManagement , отличаются от команд, предоставляемых модулем NuGet в консоли диспетчера пакетов Visual Studio. Каждый модуль имеет команды, недоступные в другом. Команды с одинаковым именем отличаются в их конкретных аргументах. Дополнительные сведения см. в справочной документации по PowerShell для консоли диспетчера пакетов Visual Studio.

Примеры

Пример 1. Установка пакета по имени пакета

Командлет Install-Package устанавливает пакет программного обеспечения и его зависимости.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -Credential Contoso\TestUser

Install-Package использует параметры для указания имен пакетов и источника. Параметр Credential использует учетную запись пользователя домена с разрешениями на установку пакетов. В командной строке будет указан пароль учетной записи пользователя.

Пример 2. Установка пакета с помощью Find-Package

В этом примере объект, возвращенный Find-Package конвейером, отправляется по конвейеру и устанавливается.Install-Package

PS> Find-Package -Name NuGet.Core -Source MyNuGet | Install-Package

Find-Package использует параметры "Имя " и "Источник " для поиска пакета. Объект отправляется по конвейеру и Install-Package устанавливает пакет на локальном компьютере.

Пример 3. Установка пакетов путем указания диапазона версий

Install-Package использует параметры MinimumVersion и MaximumVersion для указания диапазона версий программного обеспечения.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -MinimumVersion 2.8.0 -MaximumVersion 2.9.0

Install-Package использует параметры Name и Source для поиска пакета. Параметры MinimumVersion и MaximumVersion указывают диапазон версий программного обеспечения. Установлена самая высокая версия в диапазоне.

Параметры

-AcceptLicense

AcceptLicense автоматически принимает лицензионное соглашение во время установки.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AllowClobber

Переопределяет предупреждения о конфликтах с существующими командами. Перезаписывает существующие команды, имеющие то же имя, что и установленные команды.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AllowPrereleaseVersions

Разрешает установку пакетов, помеченных как предварительная версия.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AllVersions

Install-Package устанавливает все доступные версии пакета. По умолчанию устанавливается только последняя версия.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Command

Указывает одну или несколько команд, которые Install-Package выполняет поиск.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ConfigFile

Указывает путь, содержащий файл конфигурации.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Contains

Install-Package получает объекты, если параметр Contains указывает значение, соответствующее любому из значений свойств объекта.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Credential

Указывает учетную запись пользователя, которая имеет разрешение на доступ к компьютеру и выполнение команд. Введите имя пользователя, например User01, Domain01\User01 или введите объект PSCredential , созданный командлетом Get-Credential . Если ввести имя пользователя, вам будет предложено ввести пароль.

Если параметр Credential не указан, Install-Package использует текущего пользователя.

Тип:	PSCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Destination

Указывает путь к входной объекту.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DscResource

Указывает один или несколько ресурсов требуемой конфигурации состояния (DSC), которые выполняются поиском Install-Package. Find-DscResource Используйте командлет для поиска ресурсов DSC.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ExcludeVersion

Переключитесь, чтобы исключить номер версии в пути к папке.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Filter

Указывает термины для поиска в свойствах Name и Description .

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-FilterOnTag

Указывает тег, который фильтрует результаты и исключает результаты, которые не содержат указанный тег.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Force

Принудительно выполняется команда без запроса подтверждения пользователя. Переопределяет ограничения, которые предотвращают Install-Package успешное выполнение, за исключением безопасности.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ForceBootstrap

Принудительно устанавливает пакет PackageManagement для автоматического установки поставщика пакетов для указанного пакета.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Headers

Задает заголовки пакета.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Includes

Указывает, следует ли Install-Package находить все типы пакетов. Допустимые значения для этого параметра приведены следующим образом:

cmdlet
DscResource
Функция
RoleCapability
Рабочий процесс

Тип:	String[]
Допустимые значения:	Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

Принимает данные от конвейера. Задает пакет с помощью типа SoftwareIdentity пакета. Find-Package выводит объект SoftwareIdentity .

Тип:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-InstallUpdate

Указывает, что Install-Package устанавливает обновления.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MaximumVersion

Указывает максимальную разрешенную версию пакета, которую требуется установить. Если этот параметр не указан, Install-Package установите последнюю версию пакета.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MinimumVersion

Указывает минимальную допустимую версию пакета, которую требуется установить. Если этот параметр не добавлен, установите последнюю версию пакета, Install-Package которая удовлетворяет любой версии, указанной параметром MaximumVersion .

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Name

Указывает одно или несколько имен пакетов. Несколько имен пакетов должны быть разделены запятыми.

Тип:	String[]
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-NoPathUpdate

NoPathUpdate применяется только к командлету Install-Script . NoPathUpdate — это динамический параметр, добавленный поставщиком и не поддерживается Install-Package.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PackageManagementProvider

Указывает имя поставщика PackageManagement .

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ProviderName

Указывает одно или несколько имен поставщиков пакетов, для которых необходимо задать область поиска пакета. Имена поставщиков пакетов можно получить, выполнив Get-PackageProvider командлет.

Тип:	String[]
Aliases:	Provider
Допустимые значения:	Bootstrap, NuGet, PowerShellGet
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Proxy

Указывает прокси-сервер для запроса, а не подключение непосредственно к интернет-ресурсу.

Тип:	Uri
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ProxyCredential

Указывает учетную запись пользователя, которая имеет разрешение на использование прокси-сервера, указанного параметром Proxy .

Тип:	PSCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PublishLocation

Указывает путь к опубликованному расположению пакета.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RequiredVersion

Указывает точную разрешенную версию пакета, которую требуется установить. Если этот параметр не добавлен, установите последнюю версию пакета, Install-Package которая удовлетворяет любой версии, указанной параметром MaximumVersion .

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RoleCapability

Задает массив возможностей ролей.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Scope

Указывает область, для которой необходимо установить пакет. Допустимые значения для этого параметра приведены следующим образом:

Текущий пользователь
AllUsers

Тип:	String
Допустимые значения:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ScriptPublishLocation

Указывает путь к опубликованному скрипту расположению.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ScriptSourceLocation

Указывает расположение источника скрипта.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SkipDependencies

Пропускает установку зависимостей программного обеспечения.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SkipPublisherCheck

Позволяет получить версию пакета, которая является более новой, чем установленная версия. Например, установленный пакет, подписанный доверенным издателем, но новая версия не подписана цифровой подписью.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SkipValidate

Переключение, пропускающее проверку учетных данных пакета.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Source

Указывает один или несколько источников пакетов. Несколько имен источников пакета должны быть разделены запятыми. Имена источников пакетов можно получить, выполнив Get-PackageSource командлет.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Tag

Указывает одну или несколько строк для поиска в метаданных пакета.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Type

Указывает, следует ли искать пакеты с помощью модуля, скрипта или обоих. Допустимые значения для этого параметра приведены следующим образом:

Модуль
Сценарий
Все

Тип:	String
Допустимые значения:	Module, Script, All
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет при Install-Package выполнении командлета. Командлет не запускается.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Объект SoftwareIdentity можно передать в этот командлет.

Выходные данные

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Этот командлет возвращает объект SoftwareIdentity для каждого устанавливаемого пакета.

Примечания

Включение поставщика пакетов в команду может сделать динамические параметры доступными для командлета. Динамические параметры относятся к поставщику пакетов. Командлет Get-Help перечисляет наборы параметров командлета и включает набор параметров поставщика. Например, Install-Package имеет набор параметров PowerShellGet , включающий -NoPathUpdate, AllowClobberи SkipPublisherCheck.

Это важно

По состоянию на апрель 2020 г. коллекция PowerShell больше не поддерживает протокол TLS версии 1.0 и 1.1. Если вы не используете TLS 1.2 или более поздней версии, при попытке получить доступ к коллекции PowerShell появится сообщение об ошибке. Используйте следующую команду, чтобы убедиться, что используется TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Дополнительные сведения см. в объявления в блоге PowerShell.

Поделиться через

Install-Package

Синтаксис

Описание

Примеры

Пример 1. Установка пакета по имени пакета

Пример 2. Установка пакета с помощью Find-Package

Пример 3. Установка пакетов путем указания диапазона версий

Параметры

-AcceptLicense

-AllowClobber

-AllowPrereleaseVersions

-AllVersions

-Command

-ConfigFile

-Confirm

-Contains

-Credential

-Destination

-DscResource

-ExcludeVersion

-Filter

-FilterOnTag

-Force

-ForceBootstrap

-Headers

-Includes

-InputObject

-InstallUpdate

-MaximumVersion

-MinimumVersion

-Name

-NoPathUpdate

-PackageManagementProvider

-ProviderName

-Proxy

-ProxyCredential

-PublishLocation

-RequiredVersion

-RoleCapability

-Scope

-ScriptPublishLocation

-ScriptSourceLocation

-SkipDependencies

-SkipPublisherCheck

-SkipValidate

-Source

-Tag

-Type

-WhatIf

Входные данные

Выходные данные

Примечания

Связанные ссылки

Обратная связь