Update-Package (Consola del Administrador de paquetes en Visual Studio)

  • Artículo

Solo está disponible desde la consola del Administrador de paquetes NuGet en Visual Studio en Windows.

Actualiza un paquete y sus dependencias, o todos los paquetes de un proyecto, a una versión más reciente.

Sintaxis

Update-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [-Version <string>]
    [-Safe] [-Source <string>] [-IncludePrerelease] [-Reinstall] [-FileConflictAction]
    [-DependencyVersion] [-ToHighestPatch] [-ToHighestMinor] [-WhatIf] [<CommonParameters>]

En NuGet 2.8 y versiones posteriores, Update-Package se puede usar para cambiar un paquete existente en el proyecto a una versión anterior. Por ejemplo, si tiene instalado Microsoft.AspNet.MVC 5.1.0-rc1, el siguiente comando cambiaría la versión a 5.0.0:

Update-Package Microsoft.AspNet.MVC -Version 5.0.0.

Parámetros

Parámetro Descripción
Identificador Identificador del paquete que se va actualizar. Si se omite, actualiza todos los paquetes. El modificador -Id es opcional.
IgnoreDependencies Omite la actualización de las dependencias del paquete.
ProjectName Nombre del proyecto que contiene los paquetes que se van a actualizar, que de forma predeterminada son todos los proyectos.
Versión Versión que se va a usar para la actualización, que de forma predeterminada es la versión más reciente. En NuGet 3.0 y versiones posteriores, el valor de version debe ser uno de Lowest, Highest, HighestMinor o HighestPatch (equivalente a -Safe).
Caja fuerte Restringe las actualizaciones solo a versiones con la misma versión principal y secundaria que el paquete instalado actualmente.
Source URL o ruta de acceso de la carpeta del origen del paquete que se va a buscar. Las rutas de acceso pueden ser absolutas o relativas a la carpeta actual. Si se omite, Update-Package busca en el origen del paquete seleccionado actualmente.
IncludePrerelease Incluye paquetes de versión preliminar para las actualizaciones.
Volver a instalar Reinstala paquetes con sus versiones instaladas actualmente. Vea Reinstalación y actualización de paquetes.
FileConflictAction La acción que se realizará cuando se le pida que sobrescriba u omita los archivos existentes a los que hace referencia el proyecto. Los valores posibles son Overwrite, Ignore, None, OverwriteAll e IgnoreAll (3.0+).
DependencyVersion La versión de los paquetes de dependencia que se va a usar, que puede ser una de las siguientes:
  • Lowest (valor predeterminado): la versión más baja
  • HighestPatch: la versión con la revisión principal más baja, la secundaria más baja y la revisión más alta
  • HighestMinor: la versión con la revisión principal más baja, la secundaria más alta y la más alta
  • Highest (valor predeterminado para Update-Package sin parámetros): la versión más alta
Puede establecer el valor predeterminado mediante el valor dependencyVersion del archivo Nuget.Config.
ToHighestPatch Equivalente a -Safe.
ToHighestMinor Restringe las actualizaciones solo a versiones con la misma versión principal que el paquete instalado actualmente.
WhatIf Muestra lo que sucedería al ejecutar el comando sin realizar realmente la actualización.

Ninguno de estos parámetros acepta caracteres comodín ni entrada de canalización.

Parámetros comunes

Update-Package admite los siguientes parámetros comunes de PowerShell: Debug, Error Action, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction y WarningVariable.

Ejemplos

# Updates all packages in every project of the solution
Update-Package

# Updates every package in the MvcApplication1 project
Update-Package -ProjectName MvcApplication1

# Updates the Elmah package in every project to the latest version
Update-Package Elmah

# Updates the Elmah package to version 1.1.0 in every project showing optional -Id usage
Update-Package -Id Elmah -Version 1.1.0

# Updates the Elmah package within the MvcApplication1 project to the highest "safe" version.
# For example, if Elmah version 1.0.0 of a package is installed, and versions 1.0.1, 1.0.2,
# and 1.1 are available in the feed, the -Safe parameter updates the package to 1.0.2 instead
# of 1.1 as it would otherwise.
Update-Package Elmah -ProjectName MvcApplication1 -Safe

# Reinstall the same version of the original package, but with the latest version of dependencies
# (subject to version constraints). If this command rolls a dependency back to an earlier version,
# use Update-Package <dependency_name> to reinstall that one dependency without affecting the
# dependent package.
Update-Package Elmah –reinstall 

# Reinstall the Elmah package in just MyProject
Update-Package Elmah -ProjectName MyProject -reinstall

# Reinstall the same version of the original package without touching dependencies.
Update-Package Elmah –reinstall -ignoreDependencies