Update-Module

Update-Module
    [[-Name] <String[]>]
    [-RequiredVersion <Version>]
    [-MaximumVersion <Version>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

El cmdlet Update-Module instala la versión más reciente de un módulo desde una galería en línea. Se le pedirá que confirme la actualización antes de instalarla. Las actualizaciones solo se instalan para los módulos que se instalaron en el equipo local con Install-Module. Update-Module busca $env:PSModulePath en los módulos instalados.

Update-Module sin parámetros especificados actualiza todos los módulos instalados. Para especificar un módulo que se va a actualizar, use el parámetro Name. Puede actualizar a la versión específica de un módulo mediante el parámetro RequiredVersion.

Si un módulo instalado ya es la versión más reciente, el módulo no se actualiza. Si el módulo no se encuentra en $env:PSModulePath, se muestra un error.

Para mostrar los módulos instalados, use Get-InstalledModule.

En este ejemplo se actualizan todos los módulos instalados a la versión más reciente de una galería en línea.

Update-Module

En este ejemplo se actualiza un módulo específico a la versión más reciente de una galería en línea.

Update-Module -Name SpeculationControl

usa el parámetro Name de para actualizar un módulo específico, EspeculaciónControl.

En este ejemplo se hace un escenario hipotético para mostrar lo que sucede si se ejecuta Update-Module. El comando no se ejecuta.

Update-Module -WhatIf

What if: Performing the operation "Update-Module" on target "Version '2.8.0' of module
  'Carbon', updating to version '2.8.1'".
What if: Performing the operation "Update-Module" on target "Version '1.0.10' of module
  'SpeculationControl', updating to version '1.0.14'".

Update-Module usa el parámetro WhatIf para mostrar lo que sucedería si se ejecutara Update-Module.

En este ejemplo, un módulo se actualiza a una versión específica. La versión debe existir en la galería en línea o se muestra un error.

Update-Module -Name SpeculationControl -RequiredVersion 1.0.14

usa el parámetro Name de para especificar el módulo, EspeculaciónControl. El parámetro RequiredVersion especifica la versión, 1.0.14.

En este ejemplo no se solicita confirmación para actualizar el módulo a la versión más reciente de una galería en línea. Si el módulo ya está instalado, el parámetro Force vuelve a instalar el módulo.

Update-Module -Name SpeculationControl -Force

usa el parámetro Name de para especificar el módulo, EspeculaciónControl. El parámetro Force actualiza el módulo sin solicitar confirmación del usuario.

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.

Para PowerShell 5.1 o posterior, el ámbito predeterminado de una sesión con privilegios elevados es AllUsersy, en una sesión sin privilegios elevados, CurrentUser. Las actualizaciones del módulo para AllUsers, $env:ProgramFiles\PowerShell\Modules, necesitan permisos elevados. Las actualizaciones del módulo para CurrentUser, $home\Documents\PowerShell\Modules, no necesitan permisos elevados.

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

Si el módulo que especifica con el parámetro Name no se instaló mediante Install-Module, se produce un error.

Solo puede ejecutar Update-Module en módulos que instaló desde la galería en línea ejecutando Install-Module.

Si Update-Module intenta actualizar archivos binarios que están en uso, Update-Module devuelve un error que identifica los procesos del problema. Se informa al usuario de que vuelva a intentar Update-Module después de que se detengan los procesos.