Compartir a través de


Update-Module

Descarga e instala la versión más reciente de los módulos especificados desde una galería en línea en el equipo local.

Syntax

Update-Module
      [[-Name] <String[]>]
      [-RequiredVersion <String>]
      [-MaximumVersion <String>]
      [-Credential <PSCredential>]
      [-Scope <String>]
      [-Proxy <Uri>]
      [-ProxyCredential <PSCredential>]
      [-Force]
      [-AllowPrerelease]
      [-AcceptLicense]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El Update-Module cmdlet 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. Novedades solo se instalan para los módulos que se instalaron en el equipo local con Install-Module. Update-Module busca $env:PSModulePath módulos instalados.

Se trata de un cmdlet de proxy para el Update-PSResource cmdlet en Microsoft.PowerShell.PSResourceGet. Para obtener más información, consulte Update-PSResource.

Ejemplos

Ejemplo 1: Actualización de todos los módulos

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

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

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

Update-Module usa el parámetro Name para actualizar un módulo específico, SpeculationControl.

Ejemplo 3: Ver ejecuciones de Update-Module what-if

En este ejemplo se realiza un escenario hipotético para mostrar lo que sucede si Update-Module se ejecuta. 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 que muestra lo que sucedería si Update-Module se ejecutara.

Ejemplo 4: Actualización de un módulo a una versión especificada

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

Update-Module usa el parámetro Name para especificar el módulo , SpeculationControl. El parámetro RequiredVersion especifica la versión 1.0.14.

Ejemplo 5: Actualización de un módulo sin confirmación

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 reinstala el módulo.

Update-Module -Name SpeculationControl -Force

Update-Module usa el parámetro Name para especificar el módulo , SpeculationControl. El parámetro Force actualiza el módulo sin solicitar confirmación del usuario.

Parámetros

-AcceptLicense

Acepte automáticamente el contrato de licencia durante la instalación si el paquete lo requiere.

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

-AllowPrerelease

Permite actualizar un módulo con el módulo más reciente marcado como versión preliminar.

El cmdlet de proxy asigna este parámetro al parámetro versión preliminar de Update-PSResource.

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

-Confirm

Le pide confirmación antes de ejecutar Update-Module.

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

-Credential

Especifica una cuenta de usuario que tiene permiso para actualizar un módulo.

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

-Force

Fuerza una actualización de cada módulo especificado sin un mensaje para solicitar confirmación. Si el módulo ya está instalado, Force reinstala el módulo.

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

-MaximumVersion

El cmdlet de proxy usa el valor de este parámetro para crear una cadena de búsqueda de versión de NuGet que se usará con el parámetro Version de Update-PSResource.

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

-Name

Especifica los nombres de uno o varios módulos que se van a actualizar. Update-Module busca $env:PSModulePath los módulos que se van a actualizar. Si no se encuentra ninguna coincidencia en $env:PSModulePath para el nombre del módulo especificado, se produce un error.

Los caracteres comodín se aceptan en nombres de módulo. Si agrega caracteres comodín al nombre especificado y no se encuentra ninguna coincidencia, no se produce ningún error.

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

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ningún resultado.

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

-Proxy

El cmdlet de proxy omite este parámetro, ya que no es compatible con Update-PSResource.

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

-ProxyCredential

El cmdlet de proxy omite este parámetro, ya que no es compatible con Update-PSResource.

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

-RequiredVersion

El cmdlet de proxy usa el valor de este parámetro para crear una cadena de búsqueda de versión de NuGet que se usará con el parámetro Version de Update-PSResource.

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

-Scope

Especifica el ámbito de instalación del módulo. Los valores aceptables para este parámetro son AllUsers y CurrentUser. Si no se especifica Scope , la actualización se instala en el ámbito CurrentUser .

El ámbito AllUsers requiere permisos elevados e instala módulos en una ubicación accesible para todos los usuarios del equipo:

$env:ProgramFiles\PowerShell\Modules

CurrentUser no requiere permisos elevados e instala módulos en una ubicación a la que solo se puede acceder al usuario actual del equipo:

$HOME\Documents\PowerShell\Modules

Cuando no se define ningún ámbito , el valor predeterminado se establece en función de la versión de PowerShellGet.

  • En PowerShellGet versiones 2.0.0 y posteriores, el valor predeterminado es CurrentUser, que no requiere elevación para la instalación.
  • En las versiones de PowerShellGet 1.x, el valor predeterminado es AllUsers, que requiere elevación para la instalación.
Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:CurrentUser
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si Update-Module se ejecutase. 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

String[]

String

PSCredential

Uri

Salidas

Object

Notas

PowerShell incluye los siguientes alias para Update-Module:

  • Todas las plataformas:
    • upmo

Para PowerShell versión 6.0 y posteriores, el ámbito de instalación predeterminado siempre es CurrentUser. Las actualizaciones del módulo para CurrentUser, $HOME\Documents\PowerShell\Modules, no necesitan permisos elevados. Las actualizaciones del módulo para AllUsers, $env:ProgramFiles\PowerShell\Modules, necesitan permisos elevados.

El Galería de PowerShell ya no admite las versiones 1.0 y 1.1 de Seguridad de la capa de transporte (TLS). Debe usar TLS 1.2 o superior. Use el siguiente comando para asegurarse de que usa TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

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 se 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 intentarlo Update-Module una vez detenidos los procesos.