Compartir a través de

Update-Module

Módulo:
PowerShellGet v3 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.

Este es 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

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 del parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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.

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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 del parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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 del parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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 del parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MaximumVersion

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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 del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Mandatory: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 del parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Proxy

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ProxyCredential

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-RequiredVersion

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

Propiedades del parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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 del 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
Mandatory: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 del parámetro

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

Conjuntos de parámetros

(All)
Posición:Named
Mandatory: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.

La 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 comando siguiente 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 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.