Install-PackageProvider

Instala uno o varios proveedores de paquetes de administración de paquetes.

Syntax

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

Description

El Install-PackageProvider cmdlet instala los proveedores de administración de paquetes coincidentes que están disponibles en los orígenes de paquetes registrados con PowerShellGet. De forma predeterminada, esto incluye los módulos disponibles en la galería de Windows PowerShell con la etiqueta PackageManagement. El proveedor de administración de paquetes PowerShellGet se usa para buscar proveedores en estos repositorios.

Este cmdlet también instala proveedores de administración de paquetes coincidentes que están disponibles mediante la aplicación de arranque Administración de paquetes.

Este cmdlet también instala los proveedores de administración de paquetes coincidentes que están disponibles en el almacén de blobs de Azure De administración de paquetes. Use el proveedor del programa previo para buscarlos e instalarlos.

Para ejecutarse por primera vez, PackageManagement requiere una conexión a Internet para descargar el proveedor de paquetes NuGet. Sin embargo, si el equipo no tiene una conexión a Internet y necesita usar el proveedor NuGet o PowerShellGet, puede descargarlos en otro equipo y copiarlos en el equipo de destino. Utilice los siguientes pasos para hacerlo:

  1. Ejecute Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Force para instalar el proveedor desde un equipo con una conexión a Internet.
  2. Después de la instalación, puede encontrar el proveedor instalado en $env:ProgramFiles\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion> o $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>.
  3. Coloque la <ProviderName> carpeta , que en este caso es la carpeta NuGet, en la ubicación correspondiente del equipo de destino. Si el equipo de destino es un servidor Nano, debe ejecutar Install-PackageProvider desde Nano Server para descargar los archivos binarios de NuGet correctos.
  4. Reinicie PowerShell para cargar automáticamente el proveedor de paquetes. Como alternativa, ejecute Get-PackageProvider -ListAvailable para enumerar todos los proveedores de paquetes disponibles en el equipo. A continuación, use Import-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 para importar el proveedor a la sesión de Windows PowerShell actual.

Ejemplos

Ejemplo 1: Instalación de un proveedor de paquetes desde el Galería de PowerShell

Este comando instala el proveedor de paquetes GistProvider desde el Galería de PowerShell.

Install-PackageProvider -Name "GistProvider" -Verbose

Ejemplo 2: Instalación de una versión especificada de un proveedor de paquetes

En este ejemplo se instala una versión especificada del proveedor de paquetes NuGet.

El primer comando busca todas las versiones del proveedor de paquetes denominado NuGet. El segundo comando instala una versión especificada del proveedor de paquetes NuGet.

Find-PackageProvider -Name "NuGet" -AllVersions
Install-PackageProvider -Name "NuGet" -RequiredVersion "2.8.5.216" -Force

Ejemplo 3: Buscar un proveedor e instalarlo

En este ejemplo se usa Find-PackageProvider y la canalización para buscar el proveedor Gist e instalarlo.

Find-PackageProvider -Name "GistProvider" | Install-PackageProvider -Verbose

Ejemplo 4: Instalación de un proveedor en la carpeta del módulo del usuario actual

Este comando instala un proveedor de paquetes para $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies que solo el usuario actual pueda usarlo.

Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser

Parámetros

-AllVersions

Indica que este cmdlet instala todas las versiones disponibles del proveedor de paquetes. De forma predeterminada, Install-PackageProvider solo devuelve la versión más alta disponible.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-Credential

Especifica una cuenta de usuario que tiene permiso para instalar proveedores de paquetes.

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

-Force

Indica que este cmdlet fuerza todas las acciones con este cmdlet que se pueden forzar. Actualmente, esto significa que el parámetro Force actúa igual que el parámetro ForceBootstrap .

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

-ForceBootstrap

Indica que este cmdlet instala automáticamente el proveedor de paquetes.

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

-InputObject

Especifica un objeto SoftwareIdentity . Use el Find-PackageProvider cmdlet para obtener un objeto SoftwareIdentity para canalizar a Install-PackageProvider.

Type:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaximumVersion

Especifica la versión máxima permitida del proveedor de paquetes que desea instalar. Si no agrega este parámetro, Install-PackageProvider instala la versión más alta disponible del proveedor.

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

-MinimumVersion

Especifica la versión mínima permitida del proveedor de paquetes que desea instalar. Si no agrega este parámetro, Install-PackageProvider instala la versión más alta disponible del paquete que también satisface cualquier requisito especificado por el parámetro MaximumVersion .

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

-Name

Especifica uno o varios nombres de módulo del proveedor de paquetes. Separe varios nombres de paquete con comas. No se admite el uso de caracteres comodín.

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

-Proxy

Especifica un servidor proxy para la solicitud, en lugar de conectarse directamente al recurso de Internet.

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

-ProxyCredential

Especifica una cuenta de usuario que tiene permiso para usar el servidor proxy especificado por el parámetro Proxy.

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

-RequiredVersion

Especifica la versión exacta permitida del proveedor de paquetes que desea instalar. Si no agrega este parámetro, Install-PackageProvider instala la versión más alta disponible del proveedor que también satisface cualquier versión máxima especificada por el parámetro MaximumVersion .

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

-Scope

Especifica el ámbito de instalación del proveedor. Los valores permitidos para este parámetro son los siguientes:

  • AllUsers : instala proveedores en una ubicación a la que se puede acceder a todos los usuarios del equipo. De forma predeterminada, se trata de $env:ProgramFiles\PackageManagement\ProviderAssemblies.

  • CurrentUser : instala proveedores en una ubicación donde solo son accesibles para el usuario actual. De forma predeterminada, se trata de $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.

Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Source

Especifica uno o varios orígenes de paquete. Use el Get-PackageSource cmdlet para obtener una lista de orígenes de paquetes disponibles.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Puede canalizar un objeto SoftwareIdentity a este cmdlet. Use Find-PackageProvider para obtener un objeto SoftwareIdentity que se puede canalizar a Install-PackageProvider.

Notas

Importante

A partir de abril de 2020, Galería de PowerShell ya no es compatible con las versiones 1.0 y 1.1 de Seguridad de la capa de transporte (TLS). Si no usa TLS 1.2 o una versión posterior, recibirá un error al intentar obtener acceso a Galería de PowerShell. Use el siguiente comando para asegurarse de que usa TLS 1.2:

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

Para más información, consulte el anuncio en el blog de PowerShell.