Comando update (CLI de NuGet)

Se aplica a: consumo de paquetes • Versiones compatibles: todas

Actualiza todos los paquetes de un proyecto (mediante packages.config) a las versiones más recientes disponibles. Se recomienda ejecutar “restore” antes de ejecutar update. (Para actualizar un paquete individual, usa nuget install sin especificar un número de versión, en cuyo caso NuGet instala la última versión).

Nota: update no funciona con la CLI que se ejecuta en Mono (Mac OSX o Linux) o cuando se usa el formato PackageReference.

El comando update también actualiza las referencias de ensamblado en el archivo del proyecto, siempre que ya existan esas referencias. Si un paquete actualizado tiene un ensamblado agregado, no se agrega ninguna nueva referencia. Las nuevas dependencias de paquete tampoco tienen agregadas sus referencias de ensamblado. Para incluir estas operaciones como parte de una actualización, actualiza el paquete en Visual Studio mediante la UI del Administrador de paquetes o la consola del Administrador de paquetes.

Este comando también se puede usar para actualizar nuget.exe mediante la marca -self.

Uso

nuget update <configPath> [options]

donde <configPath> identifica un packages.config o un archivo de solución que enumera las dependencias del proyecto.

Opciones

  • -ConfigFile

    El archivo de configuración de NuGet que aplicar. Si no se especifica, se usa %AppData%\NuGet\NuGet.Config (Windows) o ~/.nuget/NuGet/NuGet.Config o ~/.config/NuGet/NuGet.Config (Mac/Linux).

  • -DependencyVersion [Lowest, HighestPatch, HighestMinor, Highest, Ignore]

    Especifica la versión de los paquetes de dependencia que se van 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 revisión más alta
    • Highest: la versión más alta
    • Ignore: no se usará ningún paquete de dependencia

  • -FileConflictAction [PromptUser, Overwrite, Ignore]

    Especifica la acción predeterminada cuando ya existe un archivo de un paquete en el proyecto de destino. Establécelo en Overwrite para sobrescribir siempre los archivos. Establécelo en Ignore para omitir los archivos.

    La acción PromptUser, el valor predeterminado, solicitará cada archivo en conflicto a menos que se proporcione OverwriteAll o IgnoreAll, que se aplicará a todos los archivos restantes.

  • -ForceEnglishOutput

    (3.5 y posteriores) Fuerza la ejecución de nuget.exe mediante una referencia cultural en inglés invariable.

  • -?|-help

    Muestra información de ayuda para el comando.

  • -Id

    Especifica una lista de identificadores de paquete que se van a actualizar.

  • -MSBuildPath

    (4.0 y posteriores) Especifica la ruta de acceso de MSBuild que se va a usar con el comando; prevalecerá sobre -MSBuildVersion.

  • -MSBuildVersion

    (3.2 y posteriores) Especifica la versión de MSBuild que se va a usar con este comando. Los valores admitidos son 4, 12, 14, 15.1, 15.3, 15.4, 15.5, 15.6, 15.7, 15.8, 15.9. De manera predeterminada, se selecciona MSBuild en la ruta de acceso; de lo contrario, el valor predeterminado es la versión instalada más alta de MSBuild.

  • -NonInteractive

    Suprime solicitudes de confirmaciones o de entrada de usuario.

  • -PreRelease

    Permite actualizar a versiones previas a la publicación. Esta marca no es necesaria al actualizar los paquetes preliminares que ya están instalados.

  • -RepositoryPath

    Especifica la carpeta local en la que se instalan los paquetes.

  • -Safe

    Especifica que solo se instalarán las actualizaciones con la versión más alta disponible en la misma versión principal y secundaria que el paquete instalado.

  • -Self

    Actualiza nuget.exe a la última versión. -Source se puede usar; sin embargo, el resto de argumentos se omiten. Si no se proporciona ningún origen, comprueba si hay actualizaciones de nuget.org independientemente de la configuración de NuGet.Config.

  • -Source

    Especifica la lista de orígenes de paquete (como direcciones URL) que se van a usar para las actualizaciones. Si se omite, el comando usa los orígenes proporcionados en los archivos de configuración; consulta Configuraciones comunes de NuGet.

  • -Verbosity [normal|quiet|detailed]

    Especifica la cantidad de detalles que se muestran en la salida: normal (el valor predeterminado), quiet o detailed.

  • -Version

    Cuando se usa con un id. de paquete, especifica la versión del paquete que se va a actualizar.

Consulta también Variables de entorno

Ejemplos

nuget update

# update packages installed in solution.sln, using MSBuild version 14.0 to load the solution and its project(s).
nuget update solution.sln -MSBuildVersion 14

nuget update -safe

nuget update -self