Install-PackageProvider

Módulo:: PackageManagement

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

Sintaxis

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

Ejemplos

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

Este comando instala el proveedor de paquetes GistProvider desde la 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

Solo necesita instalar el proveedor de paquetes NuGet si ejecuta PackageManagement v1.1.0.0 en Windows PowerShell. Las versiones más recientes de PowerShellGet y PackageManagement incluyen el proveedor de paquetes NuGet de forma predeterminada.

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.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Credential

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

Tipo:	PSCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 .

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ForceBootstrap

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

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

Tipo:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 .

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Name

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

Tipo:	String[]
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Proxy

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

Tipo:	Uri
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ProxyCredential

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

Tipo:	PSCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 reciente disponible del proveedor que también satisfaga cualquier versión máxima especificada por el parámetro MaximumVersion .

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Scope

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

AllUsers : instala los proveedores en una ubicación a la que puedan acceder todos los usuarios del equipo. De forma predeterminada, se trata de $env:ProgramFiles\PackageManagement\ProviderAssemblies.
CurrentUser : instala proveedores en una ubicación en la que solo puede acceder a ellos el usuario actual. De forma predeterminada, se trata de $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.

Tipo:	String
Valores aceptados:	CurrentUser, AllUsers
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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, la Galería de PowerShell ya no admite las versiones 1.0 y 1.1 de seguridad de la capa de transporte (TLS). Si no usa TLS 1.2 o superior, recibirá un error al intentar acceder a la Galería de PowerShell. Use el comando siguiente para asegurarse de que usa TLS 1.2:

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

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