Install-PackageProvider
Устанавливает один или несколько поставщиков пакетов управления пакетами.
Синтаксис
PackageBySearch (по умолчанию)
Install-PackageProvider
[-Name] <String[]>
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-Credential <PSCredential>]
[-Scope <String>]
[-Source <String[]>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
PackageByInputObject
Install-PackageProvider
[-InputObject] <SoftwareIdentity[]>
[-Scope <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Install-PackageProvider устанавливает соответствующие поставщики управления пакетами, доступные в источниках пакетов, зарегистрированных в PowerShellGet. По умолчанию это включает модули, доступные в коллекции Windows PowerShell с тегом PackageManagement . Поставщик управления пакетами PowerShellGet используется для поиска поставщиков в этих репозиториях.
Этот командлет также устанавливает соответствующие поставщики управления пакетами, доступные с помощью приложения начальной загрузки управления пакетами.
Примеры
Пример 1. Установка поставщика пакетов из коллекции PowerShell
Эта команда устанавливает поставщика пакетов GistProvider из коллекции PowerShell.
Install-PackageProvider -Name "GistProvider" -Verbose
Пример 2. Установка указанной версии поставщика пакетов
В этом примере устанавливается указанная версия поставщика пакетов NuGet.
Первая команда находит все версии поставщика пакетов с именем NuGet. Вторая команда устанавливает указанную версию поставщика пакетов NuGet.
Find-PackageProvider -Name "NuGet" -AllVersions
Install-PackageProvider -Name "NuGet" -RequiredVersion "2.8.5.216" -Force
Вам нужно установить поставщик пакетов NuGet только в том случае, если вы используете PackageManagement версии 1.1.0.0 в Windows PowerShell. Более новые версии PowerShellGet и PackageManagement по умолчанию включают поставщика пакетов NuGet.
Пример 3. Поиск поставщика и его установка
В этом примере используется Find-PackageProvider конвейер для поиска поставщика Gist и его установки.
Find-PackageProvider -Name "GistProvider" | Install-PackageProvider -Verbose
Пример 4. Установка поставщика в папку модуля текущего пользователя
Эта команда устанавливает поставщика $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies пакетов, чтобы использовать его только текущий пользователь.
Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser
Параметры
-AllVersions
Указывает, что этот командлет устанавливает все доступные версии поставщика пакетов. По умолчанию Install-PackageProvider возвращается только самая доступная версия.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Запрашивает подтверждение перед запуском cmdlet.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Credential
Указывает учетную запись пользователя, которая имеет разрешение на установку поставщиков пакетов.
Свойства параметра
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
PackageBySearch
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Указывает, что этот командлет принудительно выполняет все действия с этим командлетом. В настоящее время это означает, что параметр Force действует так же, как параметр ForceBootstrap .
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ForceBootstrap
Указывает, что этот командлет автоматически устанавливает поставщика пакетов.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InputObject
Указывает объект SoftwareIdentity .
Find-PackageProvider Используйте командлет, чтобы получить объект SoftwareIdentity для передачи вInstall-PackageProvider.
Свойства параметра
| Тип: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
PackageByInputObject
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MaximumVersion
Указывает максимальную разрешенную версию поставщика пакетов, которую требуется установить. Если этот параметр не добавлен, Install-PackageProvider установите самую доступную версию поставщика.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
PackageBySearch
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MinimumVersion
Указывает минимальную допустимую версию поставщика пакетов, которую требуется установить. Если этот параметр не добавлен, установите самую доступную версию пакета, Install-PackageProvider которая также удовлетворяет любому требованию, указанному параметром MaximumVersion .
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
PackageBySearch
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Указывает одно или несколько имен модулей поставщика пакетов. Разделите несколько имен пакетов запятыми. Подстановочные знаки не поддерживаются.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
PackageBySearch
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Proxy
Указывает прокси-сервер для запроса, а не подключение непосредственно к интернет-ресурсу.
Свойства параметра
| Тип: | Uri |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ProxyCredential
Указывает учетную запись пользователя, которая имеет разрешение на использование прокси-сервера, указанного параметром прокси-сервера.
Свойства параметра
| Тип: | PSCredential |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-RequiredVersion
Указывает точную допустимую версию поставщика пакетов, которую требуется установить. Если этот параметр Install-PackageProvider не добавлен, устанавливается самая доступная версия поставщика, которая также удовлетворяет любой максимальной версии, указанной параметром MaximumVersion .
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
PackageBySearch
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Scope
Указывает область установки поставщика. Допустимые значения для этого параметра:
AllUsers — устанавливает поставщики в расположение, доступное для всех пользователей компьютера. По умолчанию это $env:ProgramFiles\PackageManagement\ProviderAssemblies.
CurrentUser — устанавливает поставщиков в расположение, где они доступны только текущему пользователю. По умолчанию это $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Допустимые значения: | CurrentUser, AllUsers |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Source
Указывает один или несколько источников пакетов.
Get-PackageSource Используйте командлет, чтобы получить список доступных источников пакетов.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
PackageBySearch
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-WhatIf
Показывает, что произойдет, если командлет будет запущен. Командлет не выполняется.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
Microsoft.PackageManagement.Packaging.SoftwareIdentity
Объект SoftwareIdentity можно передать в этот командлет. Используется Find-PackageProvider для получения объекта SoftwareIdentity , который можно передать в Install-PackageProvider.
Примечания
Это важно
По состоянию на апрель 2020 г. коллекция PowerShell больше не поддерживает протокол TLS версии 1.0 и 1.1. Если вы не используете TLS 1.2 или более поздней версии, при попытке получить доступ к коллекции PowerShell появится сообщение об ошибке. Используйте следующую команду, чтобы убедиться, что используется TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Дополнительные сведения см. в объявления
