Install-PackageProvider

Модуль:: PackageManagement

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

Синтаксис

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>]

Install-PackageProvider
       [-Scope <String>]
       [-InputObject] <SoftwareIdentity[]>
       [-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
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

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

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

-Credential

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

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

-Force

Указывает, что этот командлет принудительно выполняет все действия с этим командлетом. В настоящее время это означает, что параметр Force действует так же, как параметр ForceBootstrap .

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

-ForceBootstrap

Указывает, что этот командлет автоматически устанавливает поставщика пакетов.

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

-InputObject

Указывает объект SoftwareIdentity . Find-PackageProvider Используйте командлет, чтобы получить объект SoftwareIdentity для передачи вInstall-PackageProvider.

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

-MaximumVersion

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

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

-MinimumVersion

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

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

-Name

Указывает одно или несколько имен модулей поставщика пакетов. Разделите несколько имен пакетов запятыми. Подстановочные знаки не поддерживаются.

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

-Proxy

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

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

-ProxyCredential

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

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

-RequiredVersion

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

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

-Scope

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

AllUsers — устанавливает поставщики в расположение, доступное для всех пользователей компьютера. По умолчанию это $env:ProgramFiles\PackageManagement\ProviderAssemblies.
CurrentUser — устанавливает поставщиков в расположение, где они доступны только текущему пользователю. По умолчанию это $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.

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

-Source

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

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

-WhatIf

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

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

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

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

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