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 использует параметры Name и Source для поиска пакета. Объект отправляется по конвейеру и 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 автоматически принимает лицензионное соглашение во время установки.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowClobber

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowPrereleaseVersions

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllVersions

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Command

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConfigFile

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Запрос подтверждения перед выполнением командлета.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Contains

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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

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

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Destination

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DscResource

Указывает один или несколько ресурсов Desired State Configuration (DSC), в которых выполняется Install-Packageпоиск . Find-DscResource Используйте командлет для поиска ресурсов DSC.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExcludeVersion

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FilterOnTag

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceBootstrap

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Headers

Указывает заголовки пакета.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Includes

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

Командлет
DscResource
Функция
RoleCapability
Рабочий процесс

Type:	String[]
Accepted values:	Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InstallUpdate

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumVersion

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinimumVersion

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

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

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoPathUpdate

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageManagementProvider

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProviderName

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

Type:	String[]
Aliases:	Provider
Accepted values:	Bootstrap, NuGet, PowerShellGet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Proxy

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

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProxyCredential

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

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PublishLocation

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequiredVersion

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RoleCapability

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

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

CurrentUser
Allusers

Type:	String
Accepted values:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptPublishLocation

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptSourceLocation

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipDependencies

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipPublisherCheck

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipValidate

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Source

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

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

Модуль
Скрипт
Все

Type:	String
Accepted values:	Module, Script, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

Microsoft.PackageManagement.Packaging.SoftwareIdentity

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

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

Microsoft.PackageManagement.Packaging.SoftwareIdentity

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

Примечания

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

Важно!

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

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

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

Share via

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

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

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

Примечания

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

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

Дополнительные ресурсы