Partager via

mise à jour du package dotnet

Cet article s’applique à : ✔️ SDK .NET 10 et versions ultérieures

Nom

dotnet package update - Mettre à jour les packages référencés dans un projet.

Synopsis

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

dotnet package update -h|--help

Descriptif

La dotnet package update commande met à jour les packages utilisés par les projets. Si NuGetAudit est activé, il peut également tenter de mettre à jour automatiquement les packages de mise à jour avec des vulnérabilités connues pour les versions fixes.

Avertissements en tant qu’erreurs

dotnet package update effectue des restaurations implicites pour vérifier si le graphique de package résultant est exempt d’erreurs. L’utilisation --vulnerable effectue également une restauration implicite pour rechercher des avertissements NuGetAudit. Toutefois, si votre projet utilise WarningsAsErrors ou TreatWarningsAsErrorssi les avertissements de restauration de NuGet peuvent entraîner l’échec de la restauration, ce qui empêche la mise à jour de se terminer.

Nous vous recommandons de tirer parti des conditions MSBuild et des variables d’environnement comme solution de contournement jusqu’à ce que cette demande de fonctionnalité soit implémentée. Par exemple, définissez <TreatWarningsAsErrors Condition=" '$(CustomCondition)' == ''>true</TreatWarningsAsErrors> dans votre projet, puis sur la plupart des interpréteurs de commandes Linux et Mac que vous pouvez exécuter CustomCondition=true dotnet package update. Dans l’invite de commandes Windows et PowerShell, vous devez définir la variable d’environnement, exécuter la mise à jour du package dotnet, puis annuler l’ensemble de la variable d’environnement sous la forme de trois commandes distinctes.

Arguments

  • packages

    Liste facultative des packages à mettre à jour. Quand aucun package n’est fourni, la commande tente de mettre à jour tous les packages référencés par le projet. Les packages peuvent être un nom de package éventuellement suivi d’un @ numéro de version et d’un numéro de version. Par exemple, dotnet package update Contoso.Utilities ou dotnet package update Contoso.Utilities@3.2.1. Lorsqu’aucune version n’est fournie, elle trouve la version la plus élevée disponible sur les sources de package configurées.

Options

  • --interactive

    Permet à la commande de s’arrêter et d’attendre une action ou une entrée utilisateur. Par exemple, pour effectuer une authentification.

  • --project <path>

    Projet dans lequel les packages doivent être mis à jour. Si un répertoire est fourni, il recherche les fichiers projet et solution dans le répertoire. La valeur par défaut est le répertoire de travail actif.

  • -v|--verbosity <LEVEL>

    Définit le niveau de détail de la commande. Les valeurs autorisées sont q[uiet], m[inimal], n[ormal], d[etailed] et diag[nostic]. Pour plus d’informations, consultez LoggerVerbosity.

  • --vulnerable

    Si la restauration signale des packages comme ayant des vulnérabilités connues, cette commande met à niveau ces packages. L’utilisation de cette option met à niveau les packages vers la version la plus basse supérieure à la version actuellement référencée, qui n’a pas de vulnérabilités connues.

  • -?|-h|--help

    Imprime une description de l’utilisation de la commande.

Examples

  • Mettre à jour tous les packages du projet vers la version la plus élevée 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.

  • Mettre à jour Contoso.Utilities vers la version la plus élevée disponible et Fabrikam.WebApi vers la version 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.

  • Mettre à jour des packages avec des vulnérabilités connues

    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