Compartir vía

Actualización de paquete de dotnet

Este artículo se aplica a: ✔️ SDK de .NET 10 y versiones posteriores

Nombre

dotnet package update - Actualizar paquetes a los que se hace referencia en un proyecto.

Sinopsis

dotnet package update [<packages>...]
    [--interactive] [--project <path>]
    [--verbosity <level>] [--vulnerable]

dotnet package update -h|--help

Description

El dotnet package update comando actualiza los paquetes usados por los proyectos. Si NuGetAudit está habilitado, también puede intentar actualizar automáticamente los paquetes de actualización con vulnerabilidades conocidas a versiones fijas.

Advertencias como errores

dotnet package update realiza restauraciones implícitas para comprobar si el gráfico de paquetes resultante está libre de errores. El uso --vulnerable de también realiza una restauración implícita para buscar advertencias de NuGetAudit. Sin embargo, si el proyecto usa WarningsAsErrors o TreatWarningsAsErrors, las advertencias de restauración de NuGet pueden provocar un error en la restauración, lo que impide que se complete la actualización.

Se recomienda aprovechar las condiciones de MSBuild y las variables de entorno como solución alternativa hasta que se implemente esta solicitud de característica . Por ejemplo, establezca <TreatWarningsAsErrors Condition=" '$(CustomCondition)' == ''>true</TreatWarningsAsErrors> en el proyecto y, a continuación, en la mayoría de los shells de Linux y Mac, puede ejecutar CustomCondition=true dotnet package update. En el símbolo del sistema de Windows y PowerShell, tendrá que establecer la variable de entorno, ejecutar la actualización del paquete dotnet y, a continuación, desenredar la variable de entorno como tres comandos independientes.

Arguments

  • packages

    Lista opcional de paquetes que se van a actualizar. Cuando no se proporciona ningún paquete, el comando intentará actualizar todos los paquetes a los que hace referencia el proyecto. Los paquetes pueden ser un nombre de paquete opcionalmente seguido de un @ número de versión y . Por ejemplo, dotnet package update Contoso.Utilities o dotnet package update Contoso.Utilities@3.2.1. Cuando no se proporciona ninguna versión, encontrará la versión más alta disponible en los orígenes de paquetes configurados.

Options

  • --interactive

    Permite que el comando se detenga y espere una entrada o una acción del usuario. Por ejemplo, para completar la autenticación.

  • --project <path>

    Proyecto en el que se deben actualizar los paquetes. Si se proporciona un directorio, busca archivos de proyecto y solución en el directorio. El valor predeterminado es el directorio de trabajo actual.

  • -v|--verbosity <LEVEL>

    Establece el nivel de detalle del comando. Los valores permitidos son q[uiet], m[inimal], n[ormal], d[etailed] y diag[nostic]. Para obtener más información, consulte LoggerVerbosity.

  • --vulnerable

    Si la restauración notifica los paquetes como si tuvieran vulnerabilidades conocidas, este comando actualizará esos paquetes. Con esta opción se actualizarán los paquetes a la versión más baja que la versión a la que se hace referencia actualmente, que no tiene vulnerabilidades conocidas.

  • -?|-h|--help

    Imprime una descripción de cómo usar el comando .

Examples

  • Actualizar todos los paquetes del proyecto a la versión más alta disponible

    dotnet package update

    Updating outdated packages in S:\src\test\update\ConsoleApp1.
  ConsoleApp1:
    Updated Microsoft.Extensions.Configuration 9.0.0 to 9.0.9.
    Updated Microsoft.Extensions.DependencyInjection 9.0.0 to 9.0.9.

Updated 2 packages in 7 scanned packages.

  • Actualice Contoso.Utilities a la versión más alta disponible y Fabrikam.WebApi a la versión 1.2.3

    dotnet package update Contoso.Utilities Fabrikam.WebApi@1.2.3

    Updating outdated packages in S:\src\test\update\ConsoleApp1.
  ConsoleApp1:
    Updated Contoso.Utilities 2.3.1 to 2.4.6.
    Updated Fabrikam.WebApi 1.0.2 to 1.2.3.

Updated 2 packages in 2 scanned packages.

  • Actualización de paquetes con vulnerabilidades conocidas

    dotnet package update --vulnerable

    Updating packages with security advisories in S:\src\test\update\ConsoleApp1
  ConsoleApp1:
    Updating System.Text.Json 8.0.0 to 8.0.5.

Updated 1 packages in 31 scanned packages.
  • Last updated on