Update-Module

Módulo:

PowerShellGet Module

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

Sintaxis

All

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

Los parámetros que toman números de versión del módulo esperan cadenas con formato de números de versión.

• Los números de versión estándar tienen un formato de x.y.z donde x, y y z son números
• Las versiones preliminares tienen un formato de x.y.z-<prerelease_label> donde la <prerelease_label> cadena arbitraria está asignada a esa versión.

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.

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

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

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

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.

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

usa el parámetro Name de para especificar el módulo, EspeculaciónControl. 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 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.

Parámetros

-AcceptLicense

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

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-AllowPrerelease

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

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Confirm

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

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	False
Admite caracteres comodín:	False
DontShow:	False
Alias:	cf

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Credential

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

Propiedades de parámetro

Tipo:	PSCredential
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-Force

Fuerza una actualización de cada módulo especificado sin una solicitud de confirmación. Si el módulo ya está instalado, Force vuelve a instalar el módulo.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-MaximumVersion

Especifica la versión máxima de un único módulo que se va a actualizar. No puede agregar este parámetro si intenta actualizar varios módulos. El MaximumVersion y los parámetros requiredVersion no se pueden usar en el mismo comando.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	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 encuentran coincidencias en $env:PSModulePath para el nombre del módulo especificado, se produce un error.

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

Propiedades de parámetro

Tipo:	String[]
Valor predeterminado:	None
Admite caracteres comodín:	True
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	0
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ninguna salida.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Proxy

Especifica un servidor proxy para la solicitud, en lugar de conectarse directamente a un recurso de Internet.

Propiedades de parámetro

Tipo:	Uri
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-ProxyCredential

Especifica una cuenta de usuario que tiene permiso para usar el servidor proxy especificado por el parámetro Proxy .

Propiedades de parámetro

Tipo:	PSCredential
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-RequiredVersion

Especifica la versión exacta a la que se actualizará el módulo instalado existente. La versión especificada por RequiredVersion debe existir en la galería en línea o se muestra un error. Si se actualiza más de un módulo en un solo comando, no puede usar RequiredVersion.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	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.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	CurrentUser
Valores aceptados:	CurrentUser, AllUsers
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-WhatIf

Muestra lo que ocurriría si se ejecuta Update-Module. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	False
Admite caracteres comodín:	False
DontShow:	False
Alias:	Wi

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

CommonParameters

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.

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.

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.

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 especificado 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.

Vínculos relacionados

• Find-Module
• Get-InstalledModule
• Install-Module
• Publish-Module
• Uninstall-Module