Install-Package
Instala uno o varios paquetes de software.
Sintaxis
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 sus proveedores.
Importante
Los comandos contenidos en el módulo PackageManagement son diferentes de los comandos proporcionados por 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: Instalación de 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-Packageusa parámetros para especificar el nombre y elorigen de los paquetes. 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-AllowClobber
Invalida mensajes de advertencia sobre conflictos con comandos existentes. Sobrescribe los comandos existentes que tienen el mismo nombre que los comandos que se instalan.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-AllowPrereleaseVersions
Permite la instalación de paquetes marcados como versión preliminar.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-AllVersions
Install-Package instala todas las versiones disponibles del paquete. De forma predeterminada, solo se instala la versión más reciente.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Command
Especifica uno o varios comandos que Install-Package busca.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ConfigFile
Especifica una ruta de acceso que contiene un archivo de configuración.
| Tipo: | String |
| 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 |
-Contains
Install-Package obtiene objetos si el parámetro Contains especifica un valor que coincide con cualquiera de los valores de propiedad del objeto.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | PSCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Destination
Especifica una ruta de acceso a un objeto de entrada.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DscResource
Especifica uno o varios recursos de Desired State Configuration (DSC) buscados por Install-Package. Use el Find-DscResource cmdlet para buscar recursos de DSC.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ExcludeVersion
Cambie para excluir el número de versión en la ruta de acceso de la carpeta.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Filter
Especifica los términos que se van a buscar en las propiedades Nombre y Descripción .
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-FilterOnTag
Especifica una etiqueta que filtra los resultados y excluye los resultados que no contienen la etiqueta especificada.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Force
Obliga a que el comando se ejecute sin pedir confirmación del usuario. Invalida las restricciones que impiden Install-Package que se realicen correctamente, a excepción de la seguridad.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ForceBootstrap
Obliga a PackageManagement a instalar automáticamente el proveedor de paquetes para el paquete especificado.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Headers
Especifica los encabezados del paquete.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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
| Tipo: | String[] |
| Valores aceptados: | Cmdlet, DscResource, Function, RoleCapability, Workflow |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-InputObject
Acepta entrada de pipeline. Especifica un paquete mediante el tipo SoftwareIdentity del paquete.
Find-Package genera un objeto SoftwareIdentity .
| Tipo: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-InstallUpdate
Indica que Install-Package instala actualizaciones.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| 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 paquete que desea instalar. Si no agrega este parámetro, Install-Package instala la versión más reciente del paquete que satisface cualquier versión 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 |
-Name
Especifica uno o varios nombres de paquete. Varios nombres de paquete deben estar separados por comas.
| Tipo: | String[] |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PackageManagementProvider
Especifica el nombre del proveedor PackageManagement .
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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. Para obtener los nombres de proveedor de paquetes, ejecute el Get-PackageProvider cmdlet .
| Tipo: | String[] |
| Alias: | Provider |
| Valores aceptados: | Bootstrap, NuGet, PowerShellGet |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Proxy
Especifica un servidor proxy para la solicitud, en lugar de conectarse directamente a un 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 |
-PublishLocation
Especifica la ruta de acceso a la ubicación publicada de un paquete.
| Tipo: | String |
| 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 paquete que desea instalar. Si no agrega este parámetro, Install-Package instala la versión más reciente del paquete que satisface cualquier versión 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 |
-RoleCapability
Especifica una matriz de funcionalidades de rol.
| 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 para el que se va a instalar el paquete. Los valores aceptables para este parámetro son los siguientes:
- UsuarioActual
- AllUsers
| 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 |
-ScriptPublishLocation
Especifica la ruta de acceso a la ubicación publicada de un script.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ScriptSourceLocation
Especifica la ubicación de origen del script.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-SkipDependencies
Omite la instalación de dependencias de software.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 publicador de confianza, pero una nueva versión no está firmada digitalmente.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-SkipValidate
Cambie que omita la validación de las credenciales de un paquete.
| Tipo: | SwitchParameter |
| 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. 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 .
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Tag
Especifica una o varias cadenas para buscar en los metadatos del paquete.
| Tipo: | String[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Type
Especifica si se van a buscar paquetes con un módulo, un script o ambos. Los valores aceptables para este parámetro son los siguientes:
- Módulo
- Guión
- Todos
| Tipo: | String |
| Valores aceptados: | Module, Script, All |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si Install-Package se ejecuta el cmdlet. 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.
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, 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.
