Install-Package

Módulo:

PackageManagement

Instala uno o varios paquetes de software.

Syntax

Install-Package
       [-Name] <String[]>
       [-RequiredVersion <String>]
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-Source <String[]>]
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ProviderName <String[]>]
       [<CommonParameters>]

Install-Package
       [-InputObject] <SoftwareIdentity[]>
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]

Description

El Install-Package cmdlet instala uno o varios paquetes de software en el equipo local. Si tiene varios orígenes de software, use Get-PackageProvider y Get-PackageSource para mostrar detalles sobre los proveedores.

Importante

Los comandos contenidos en el módulo PackageManagement son diferentes de los que proporciona el módulo NuGet en la consola del Administrador de paquetes de Visual Studio. Cada módulo tiene comandos que no están disponibles en el otro. Los comandos con el mismo nombre difieren en sus argumentos específicos. Para obtener más información, consulte la documentación de referencia de PowerShell para la consola del Administrador de paquetes de Visual Studio.

Ejemplos

Ejemplo 1: Instalar un paquete por nombre de paquete

El Install-Package cmdlet instala un paquete de software y sus dependencias.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -Credential Contoso\TestUser

Install-Package usa parámetros para especificar los paquetes Name y Source. El parámetro Credential usa una cuenta de usuario de dominio con permisos para instalar paquetes. El comando le pide la contraseña de la cuenta de usuario.

Ejemplo 2: Usar Find-Package para instalar un paquete

En este ejemplo, el objeto devuelto por Find-Package se envía a la canalización e instala .Install-Package

PS> Find-Package -Name NuGet.Core -Source MyNuGet | Install-Package

Find-Package usa los parámetros Name y Source para buscar un paquete. El objeto se envía a la canalización e Install-Package instala el paquete en el equipo local.

Ejemplo 3: Instalación de paquetes mediante la especificación de un intervalo de versiones

Install-Package usa los parámetros MinimumVersion y MaximumVersion para especificar un intervalo de versiones de software.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -MinimumVersion 2.8.0 -MaximumVersion 2.9.0

Install-Package usa los parámetros Name y Source para buscar un paquete. Los parámetros MinimumVersion y MaximumVersion especifican un intervalo de versiones de software. Se instala la versión más alta del intervalo.

Parámetros

-AcceptLicense

AcceptLicense acepta automáticamente el contrato de licencia durante la instalación.

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

-AllowClobber

Invalida los mensajes de advertencia sobre conflictos con los comandos existentes. Sobrescribe los comandos existentes que tienen el mismo nombre que los comandos que se instalan.

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

-AllowPrereleaseVersions

Permite la instalación de paquetes marcados como versión preliminar.

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

-AllVersions

Install-Package instala todas las versiones disponibles del paquete. De forma predeterminada, solo se instala la versión más reciente.

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

-Command

Especifica uno o varios comandos que Install-Package busca.

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

-ConfigFile

Especifica una ruta de acceso que contiene un archivo de configuración.

Type:	String
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

-Contains

Install-Package obtiene objetos si el parámetro Contains especifica un valor que coincide con cualquiera de los valores de propiedad del objeto.

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

-Credential

Especifica una cuenta de usuario que tiene permiso para acceder al equipo y ejecutar comandos. Escriba un nombre de usuario, como User01, Domain01\User01, o escriba un objeto PSCredential , generado por el Get-Credential cmdlet . Si escribe un nombre de usuario, se le pedirá una contraseña.

Cuando no se especifica el parámetro Credential , Install-Package usa el usuario actual.

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

-Destination

Especifica una ruta de acceso a un objeto de entrada.

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

-DscResource

Especifica uno o varios recursos de Desired State Configuration (DSC) que busca Install-Package. Use el Find-DscResource cmdlet para buscar recursos de DSC.

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

-ExcludeVersion

Cambie para excluir el número de versión en la ruta de acceso de la carpeta.

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

-Filter

Especifica los términos que se van a buscar en las propiedades Nombre y Descripción .

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

-FilterOnTag

Especifica una etiqueta que filtra los resultados y excluye los resultados que no contienen la etiqueta especificada.

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

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario. Invalida las restricciones que impiden Install-Package que se realicen correctamente, con la excepción de la seguridad.

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

-ForceBootstrap

Obliga a PackageManagement a instalar automáticamente el proveedor de paquetes para el paquete especificado.

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

-Headers

Especifica los encabezados del paquete.

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

-Includes

Especifica si Install-Package debe encontrar todos los tipos de paquete. Los valores aceptables para este parámetro son los siguientes:

• Cmdlet
• DscResource
• Función
• RoleCapability
• Flujo de trabajo

Type:	String[]
Accepted values:	Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Acepta la entrada de canalización. Especifica un paquete mediante el tipo SoftwareIdentity del paquete. Find-Package genera un objeto SoftwareIdentity .

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

-InstallUpdate

Indica que Install-Package instala actualizaciones.

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

-MaximumVersion

Especifica la versión máxima permitida del paquete que desea instalar. Si no especifica este parámetro, Install-Package instala la versión más reciente del paquete.

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 paquete que desea instalar. Si no agrega este parámetro, Install-Package instala la versión más reciente del paquete que satisfaga cualquier versión especificada 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 paquete. Varios nombres de paquete deben estar separados por comas.

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

-NoPathUpdate

NoPathUpdate solo se aplica al Install-Script cmdlet . NoPathUpdate es un parámetro dinámico agregado por el proveedor y no es compatible con Install-Package.

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

-PackageManagementProvider

Especifica el nombre del proveedor PackageManagement .

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

-ProviderName

Especifica uno o varios nombres de proveedor de paquetes a los que se va a definir el ámbito de la búsqueda del paquete. Puede obtener los nombres de proveedor del paquete mediante la ejecución del cmdlet Get-PackageProvider.

Type:	String[]
Aliases:	Provider
Accepted values:	Bootstrap, NuGet, PowerShellGet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Proxy

Especifica un servidor proxy para la solicitud, en lugar de conectarse directamente a un 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

-PublishLocation

Especifica la ruta de acceso a la ubicación publicada de un paquete.

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

-RequiredVersion

Especifica la versión exacta permitida del paquete que desea instalar. Si no agrega este parámetro, Install-Package instala la versión más reciente del paquete que satisfaga cualquier versión especificada por el parámetro MaximumVersion .

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

-RoleCapability

Especifica una matriz de funcionalidades de rol.

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

-Scope

Especifica el ámbito para el que se va a instalar el paquete. Los valores aceptables para este parámetro son los siguientes:

• CurrentUser
• AllUsers

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

-ScriptPublishLocation

Especifica la ruta de acceso a la ubicación publicada de un script.

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

-ScriptSourceLocation

Especifica la ubicación de origen del script.

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

-SkipDependencies

Omite la instalación de dependencias de software.

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

-SkipPublisherCheck

Permite obtener una versión de paquete más reciente que la versión instalada. Por ejemplo, un paquete instalado firmado digitalmente por un editor de confianza, pero una nueva versión no está firmada digitalmente.

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

-SkipValidate

Cambie que omita la validación de las credenciales de un paquete.

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

-Source

Especifica uno o varios orígenes de paquetes. Los nombres de origen de varios paquetes deben estar separados por comas. Para obtener los nombres de origen del paquete, ejecute el Get-PackageSource cmdlet .

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

-Tag

Especifica una o varias cadenas que se van a buscar en los metadatos del paquete.

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

-Type

Especifica si se deben buscar paquetes con un módulo, un script o ambos. Los valores aceptables para este parámetro son los siguientes:

• módulo
• Script
• Todo

Type:	String
Accepted values:	Module, Script, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Muestra lo que sucedería si Install-Package se ejecuta 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.

Salidas

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Este cmdlet devuelve un objeto SoftwareIdentity para cada paquete que instala.

Notas

Incluir un proveedor de paquetes en un comando puede hacer que los parámetros dinámicos estén disponibles para un cmdlet. Los parámetros dinámicos son específicos de un proveedor de paquetes. El Get-Help cmdlet enumera los conjuntos de parámetros de un cmdlet e incluye el conjunto de parámetros del proveedor. Por ejemplo, Install-Package tiene establecido el parámetro PowerShellGet que incluye -NoPathUpdate, AllowClobbery SkipPublisherCheck.

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.

Vínculos relacionados

• about_PackageManagement
• Find-DscResource
• Get-Help
• Get-Package
• Get-PackageProvider
• Get-PackageSource
• Find-Package
• Save-Package
• Uninstall-Package