Install-Module

Install-Module
    [-Name] <string[]>
    [-MinimumVersion <version>]
    [-MaximumVersion <version>]
    [-RequiredVersion <version>]
    [-Repository <string[]>]
    [-Scope <string>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Install-Module
    [-InputObject] <psobject[]>
    [-Scope <string>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

El Install-Module cmdlet 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.

Si el módulo que se va a instalar tiene el mismo nombre o versión, o contiene comandos en un módulo existente, se muestran los mensajes de advertencia. Después de confirmar que desea instalar el módulo y anular las advertencias, utilice el -Force parámetro. En función de la configuración del repositorio, es posible que tenga que responder a una solicitud de instalación del módulo para continuar.

En estos ejemplos se usa la Galería de PowerShell como único repositorio registrado. Get-PSRepository muestra los repositorios registrados. Si tiene varios repositorios registrados, use el parámetro para especificar el -Repository nombre del repositorio.

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

Find-Module -Name PowerShellGet | Install-Module

Find-Module 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\WindowsPowerShell\Modules.

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

Install-Module -Name PowerShellGet

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

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

Install-Module 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 y se instala. Dado que la versión 2.0.4 está disponible, esa versión se descarga e instala para todos los usuarios.

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

Install-Module -Name PowerShellGet -RequiredVersion 2.0.0

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

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

Install-Module 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\WindowsPowerShell\Modules.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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

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 contengan 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, MaximumVersion o 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\WindowsPowerShell\Modules. El valor predeterminado impide confusiones al instalar recursos de Desired State Configuration (DSC) de PowerShell.

La instalación de un módulo falla y no se puede importar si no tiene un .psm1, .psd1, o .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 y no se utilizan los parámetros MinimumVersion o RequiredVersion , continúa de forma silenciosa, Install-Module 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 , continúa silenciosamente, Install-Module pero no instala el módulo.

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