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.
Related Links
PowerShellGet