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-ModuleEjemplo 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 SpeculationControlUpdate-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.14Update-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 -ForceUpdate-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[]
Salidas
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.
Vínculos relacionados
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de