Import-PackageProvider

Adds Package Management package providers to the current session.

Syntax

Import-PackageProvider
      [-Name] <String[]>
      [-RequiredVersion <String>]
      [-MinimumVersion <String>]
      [-MaximumVersion <String>]
      [-Force]
      [-ForceBootstrap]
      [<CommonParameters>]

Description

The Import-PackageProvider cmdlet adds one or more package providers to the current session. The provider that you import must be installed on the local computer.

To get a list of available providers, run Get-PackageProvider -ListAvailable. Note that a package provider name can be different from its module name.

Due to security reasons, PackageManagement requires C#-based providers to contain a provider.manifest. For more information on how to build a provider with provider.manifest injected, see the .csproj project files on https://github.com/oneget/oneget.

Examples

Example 1: Import a package provider from the local computer

PS C:\> Import-PackageProvider -Name "Nuget"

This command imports the Nuget provider after it has been installed on the local computer.

Example 2: Import a specific version of a package provider

PS C:\> Find-PackageProvider -Name "Nuget" -AllVersions
Install-PackageProvider -Name "Nuget" -RequiredVersion "2.8.5.201" -Force
Get-PackageProvider -ListAvailable
Import-PackageProvider -Name "Nuget" -RequiredVersion "2.8.5.201" -Verbose

This command finds, installs, and imports a specific version of the Nuget package provider.

Parameters

-Force

Forces the command to run without asking for user confirmation. Re-imports a package provider.

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

-ForceBootstrap

Indicates that this cmdlet forces Package Management to automatically install the package provider.

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

-MaximumVersion

Specifies the maximum allowed version of the package provider that you want to import. If you do not add this parameter, Import-PackageProvider imports the highest available version of the provider.

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

-MinimumVersion

Specifies the minimum allowed version of the package provider that you want to import. If you do not add this parameter, Import-PackageProvider imports the highest available version of the package that also satisfies any maximum version that is specified using the MaximumVersion parameter.

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

-Name

Specifies one or more package provider names. Wildcards are not permitted.

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

-RequiredVersion

Specifies the exact version of the package provider that you want to import. If you do not add this parameter, Import-PackageProvider imports the highest available version of the provider that also satisfies any maximum version specified using the MaximumVersion parameter.

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

Inputs

Microsoft.PackageManagement.Implementation.PackageProvider

You can pipe a PackageProvider object returned by Get-PackageProvider into Import-PackageProvider.

Notes

Important

As of April 2020, the PowerShell Gallery no longer supports Transport Layer Security (TLS) versions 1.0 and 1.1. If you are not using TLS 1.2 or higher, you will receive an error when trying to access the PowerShell Gallery. Use the following command to ensure you are using TLS 1.2:

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

For more information, see the announcement in the PowerShell blog.