Install-Module

Sintaxis

Install-Module
       [-Name] <String[]>
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-RequiredVersion <String>]
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <String>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-Force]
       [-AllowPrerelease]
       [-AcceptLicense]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-Module
       [-InputObject] <PSObject[]>
       [-Credential <PSCredential>]
       [-Scope <String>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-Force]
       [-AcceptLicense]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

El cmdlet Install-Module obtiene uno o varios módulos que cumplen los criterios especificados de un repositorio en línea. El cmdlet comprueba que los resultados de búsqueda son módulos válidos y copia las carpetas de módulo en la ubicación de instalación. Los módulos instalados no se importan automáticamente después de la instalación. Puede filtrar qué módulo se instala en función de las versiones mínimas, máximas y exactas de los módulos especificados.

Este es un cmdlet de proxy para el cmdlet Get-InstalledPSResource en el Microsoft.PowerShell.PSResourceGet. Para obtener más información, vea Install-PSResource.

Ejemplos

Ejemplo 1: Buscar e instalar un módulo

En este ejemplo se busca un módulo en el repositorio y se instala el módulo.

Find-Module -Name PowerShellGet | Install-Module

El usa el parámetro Name para especificar el módulo PowerShellGet. De forma predeterminada, la versión más reciente del módulo se descarga del repositorio. El objeto se envía a la canalización al cmdlet Install-Module. Install-Module instala el módulo para todos los usuarios de $env:ProgramFiles\PowerShell\Modules.

Ejemplo 2: Instalación de un módulo por nombre

En este ejemplo, se instala la versión más reciente del módulo PowerShellGet.

Install-Module -Name PowerShellGet

El usa el parámetro Name para especificar el módulo PowerShellGet. De forma predeterminada, la versión más reciente del módulo se descarga del repositorio y se instala.

Ejemplo 3: Instalación de un módulo con su versión mínima

En este ejemplo, se instala la versión mínima del módulo PowerShellGet. El parámetro MinimumVersion especifica la versión más baja del módulo que se debe instalar. Si hay disponible una versión más reciente del módulo, esa versión se descarga e instala para todos los usuarios.

Install-Module -Name PowerShellGet -MinimumVersion 2.0.1

El usa el parámetro Name para especificar el módulo PowerShellGet. El parámetro MinimumVersion especifica que la versión 2.0.1 se descarga del repositorio e instala. Dado que la versión 2.0.4 está disponible, esa versión se descarga e instala para todos los usuarios.

Ejemplo 4: Instalación de una versión específica de un módulo

En este ejemplo, se instala una versión específica del módulo PowerShellGet.

Install-Module -Name PowerShellGet -RequiredVersion 2.0.0

El usa el parámetro Name para especificar el módulo PowerShellGet. El parámetro RequiredVersion especifica que la versión 2.0.0 se descarga e instala para todos los usuarios.

Ejemplo 5: Instalar un módulo solo para el usuario actual

En este ejemplo se descarga e instala la versión más reciente de un módulo, solo para el usuario actual.

Install-Module -Name PowerShellGet -Scope CurrentUser

El usa el parámetro Name para especificar el módulo PowerShellGet. Install-Module descarga e instala la versión más reciente de PowerShellGet en el directorio del usuario actual, $HOME\Documents\PowerShell\Modules.

Ejemplo 6: Instalación de la versión preliminar más reciente de un módulo

En este ejemplo se muestra cómo instalar la versión más reciente de un módulo cuando esa versión es una versión preliminar. La instalación de una versión preliminar requiere el parámetro AllowPrerelease.

Install-Module -Name Microsoft.PowerShell.Crescendo -AllowPrerelease

Con este método se obtiene la versión más reciente disponible. Si la versión más reciente no es una versión preliminar, obtendrá la versión estable más reciente del módulo.

Ejemplo 7: Instalación de una versión preliminar específica de un módulo

En este ejemplo se muestra cómo instalar una versión preliminar específica de un módulo. El cmdlet Find-Module se puede usar para buscar versiones preliminares de módulos en la Galería de PowerShell.

Las versiones preliminares tienen un formato de <version_number>-<prerelease_label>.

Find-Module PSReadLine -AllVersions -AllowPrerelease | Select-Object -First 5

Version        Name             Repository       Description
-------        ----             ----------       -----------
2.2.6          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.5          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.4-beta1    PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.3          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.2          PSReadLine       PSGallery        Great command line editing in the PowerS…

Install-Module -Name PSReadLine -RequiredVersion 2.2.4-beta1 -AllowPrerelease

Use la versión que se muestra en la Galería de PowerShell para el valor del parámetro RequiredVersion.

Parámetros

-AcceptLicense

-AllowClobber

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-MaximumVersion

-MinimumVersion

-Name

-PassThru

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Scope

-SkipPublisherCheck

-WhatIf

Entradas

PSRepositoryItemInfo

Find-Module crea objetos PSRepositoryItemInfo que se pueden enviar por la canalización a Install-Module.

String[]

PSObject[]

String

PSCredential

Uri

Salidas

Microsoft.PowerShell.Commands.PSRepositoryItemInfo

Al usar el parámetro PassThru, Install-Module genera un objeto PSRepositoryItemInfo para el módulo. Esta es la misma información que obtiene del cmdlet Find-Module.

Notas

PowerShell incluye los siguientes alias para Install-Module:

• Todas las plataformas:
  • inmo

Install-Module se ejecuta en PowerShell 5.0 o versiones posteriores, en Windows 7 o Windows 2008 R2 y versiones posteriores de Windows.

Como procedimiento recomendado de seguridad, evalúe el código de un módulo antes de ejecutar los cmdlets o funciones por primera vez. Para evitar la ejecución de módulos que contienen código malintencionado, los módulos instalados no se importan automáticamente después de la instalación.

Si el nombre del módulo especificado por el parámetro Name no existe en el repositorio, Install-Module devuelve un error.

Para instalar varios módulos, use el parámetro Name y especifique una matriz separada por comas de nombres de módulo. Si especifica varios nombres de módulo, no puede usar MinimumVersion, MaximumVersiono RequiredVersion. Find-Module crea objetos PSRepositoryItemInfo que se pueden enviar por la canalización a Install-Module. La canalización es otra manera de especificar varios módulos que se van a instalar en un solo comando.

De forma predeterminada, los módulos para el ámbito de AllUsers se instalan en $env:ProgramFiles\PowerShell\Modules. El valor predeterminado impide confusiones al instalar recursos de Desired State Configuration (DSC) de PowerShell.

Se produce un error en la instalación de un módulo y no se puede importar si no tiene una .psm1, .psd1o .dll del mismo nombre dentro de la carpeta. Use el parámetro Force para instalar el módulo.

Si la versión de un módulo existente coincide con el nombre especificado por el parámetro Name de y el parámetro MinimumVersion o RequiredVersion no se usan, continúa silenciosamente, pero no instala el módulo.

Si la versión de un módulo existente es mayor que el valor del parámetro MinimumVersion, o igual que el valor del parámetro RequiredVersion, Install-Module continúa silenciosamente, pero no instala el módulo.

Si el módulo existente no coincide con los valores especificados por el MinimumVersion o parámetros RequiredVersion, se produce un error en el comando Install-Module. Por ejemplo, si la versión del módulo instalado existente es inferior al valor MinimumVersion o no es igual al valor de RequiredVersion.

Install-Module también instala los módulos dependientes especificados según sea necesario para el publicador del módulo. El publicador enumera los módulos necesarios y sus versiones en el manifiesto del módulo.

Vínculos relacionados

• Find-Module
• Get-PSRepository
• Import-Module
• Publish-Module
• Register-PSRepository
• Uninstall-Module
• Update-Module
• about_Module