Dela via

dotnet-paketuppdatering

Den här artikeln gäller för: ✔️ .NET 10 SDK och senare versioner

Namn

dotnet package update – Uppdatera refererade paket i ett projekt.

Sammanfattning

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

dotnet package update -h|--help

Description

Kommandot dotnet package update uppdaterar paket som används av projekt. Om NuGetAudit är aktiverat kan det också försöka uppdatera uppdateringspaket automatiskt med kända säkerhetsrisker för fasta versioner.

Varningar som fel

dotnet package update gör implicita återställningar för att kontrollera om det resulterande paketdiagrammet är fritt från fel. Att använda --vulnerable gör också en implicit återställning för att hitta NuGetAudit-varningar. Men om projektet använder WarningsAsErrors eller TreatWarningsAsErrorskan NuGets återställningsvarningar orsaka att återställningen misslyckas, vilket hindrar uppdateringen från att slutföras.

Vi rekommenderar att du använder MSBuild-villkor och miljövariabler som en lösning tills den här funktionsbegäran har implementerats. Ange till exempel <TreatWarningsAsErrors Condition=" '$(CustomCondition)' == ''>true</TreatWarningsAsErrors> i projektet och sedan på de flesta Linux- och Mac-gränssnitt kan du köra CustomCondition=true dotnet package update. I Windows-kommandotolken och PowerShell måste du ange miljövariabeln, köra dotnet-paketuppdateringen och sedan ta bort miljövariabeln som tre separata kommandon.

Arguments

  • packages

    En valfri lista över paket som ska uppdateras. När inga paket tillhandahålls försöker kommandot uppdatera alla paket som refereras av projektet. Paket kan vara ett paketnamn, eventuellt följt av ett @ versionsnummer och ett versionsnummer. Till exempel dotnet package update Contoso.Utilities eller dotnet package update Contoso.Utilities@3.2.1. När ingen version har angetts hittar den högsta tillgängliga versionen på de konfigurerade paketkällorna.

Options

  • --interactive

    Tillåter att kommandot stoppar och väntar på användarens indata eller åtgärd. Till exempel för att slutföra autentiseringen.

  • --project <path>

    Projektet som paketen ska uppdateras i. Om en katalog tillhandahålls söker den efter projekt- och lösningsfiler i katalogen. Standardvärdet är den aktuella arbetskatalogen.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Mer information finns i LoggerVerbosity.

  • --vulnerable

    Om återställning rapporterar några paket som har kända sårbarheter uppgraderar det här kommandot dessa paket. Med det här alternativet uppgraderas paket till den lägsta versionen som är högre än den aktuella versionen, som inte har några kända säkerhetsrisker.

  • -?|-h|--help

    Skriver ut en beskrivning av hur du använder kommandot.

Examples

  • Uppdatera alla paket i projektet till den högsta tillgängliga versionen

    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.

  • Uppdatera Contoso.Utilities till den högsta tillgängliga versionen och Fabrikam.WebApi till 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.

  • Uppdatera paket med kända säkerhetsrisker

    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