Install-Package
Устанавливает один или несколько пакетов программного обеспечения.
Синтаксис
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.
Связанные ссылки
PowerShellGet