Update-Package (Consola del Administrador de paquetes en Visual Studio)
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:
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