dotnet-pakketupdate

Dit artikel is van toepassing op: ✔️ .NET 10 SDK en latere versies

Naam

dotnet package update - Werk pakketten waarnaar wordt verwezen bij in een project.

Samenvatting

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

dotnet package update -h|--help

Description

Met de dotnet package update opdracht worden pakketten bijgewerkt die door projecten worden gebruikt. Als NuGetAudit is ingeschakeld, kan het ook proberen om automatisch updatepakketten met bekende beveiligingsproblemen naar vaste versies bij te werken.

Waarschuwingen als fouten

dotnet package update voert impliciete herstelbewerkingen uit om te controleren of de resulterende pakketgrafiek vrij is van fouten. Het gebruik doet --vulnerable ook een impliciete herstelbewerking om NuGetAudit-waarschuwingen te vinden. Als uw project echter gebruikmaakt WarningsAsErrors van de herstelwaarschuwingen van NuGet, TreatWarningsAsErrorskan dit ertoe leiden dat het herstellen mislukt, waardoor de update niet kan worden voltooid.

We raden u aan om te profiteren van MSBuild-voorwaarden en omgevingsvariabelen als tijdelijke oplossing totdat deze functieaanvraag is geïmplementeerd. Stel bijvoorbeeld <TreatWarningsAsErrors Condition=" '$(CustomCondition)' == ''>true</TreatWarningsAsErrors> in uw project in en vervolgens op de meeste Linux- en Mac-shells die u kunt uitvoeren CustomCondition=true dotnet package update. In windows-opdrachtprompt en PowerShell moet u de omgevingsvariabele instellen, dotnet-pakketupdate uitvoeren en vervolgens de omgevingsvariabele opheffen als drie afzonderlijke opdrachten.

Arguments

• packages

  Een optionele lijst met pakketten die moeten worden bijgewerkt. Wanneer er geen pakketten worden opgegeven, probeert de opdracht alle pakketten waarnaar wordt verwezen door het project bij te werken. Pakketten kunnen een pakketnaam zijn, eventueel gevolgd door een @ en een versienummer. Een voorbeeld hiervan is dotnet package update Contoso.Utilities of dotnet package update Contoso.Utilities@3.2.1. Wanneer er geen versie is opgegeven, wordt de hoogste versie gevonden die beschikbaar is op de geconfigureerde pakketbronnen.

Options

• --interactive

  Hiermee kan de opdracht stoppen en wachten op invoer of actie van de gebruiker. Bijvoorbeeld om de verificatie te voltooien.

• --project <path>

  Het project waarin pakketten moeten worden bijgewerkt. Als er een map is opgegeven, wordt gezocht naar project- en oplossingsbestanden in de map. Standaard ingesteld op de huidige werkmap.

• -v|--verbosity <LEVEL>

  Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijnq[uiet], , , m[inimal]en n[ormal]d[etailed]diag[nostic]. Zie LoggerVerbosity voor meer informatie.

• --vulnerable

  Als herstel alle pakketten rapporteert als bekende beveiligingsproblemen, worden deze pakketten bijgewerkt met deze opdracht. Als u deze optie gebruikt, worden pakketten bijgewerkt naar de laagste versie die hoger is dan de versie waarnaar momenteel wordt verwezen, die geen bekende beveiligingsproblemen heeft.

• -?|-h|--help

  Hiermee wordt een beschrijving afgedrukt van hoe de opdracht gebruikt moet worden.

Voorbeelden

• Alle pakketten in het project bijwerken naar de hoogste beschikbare versie

  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.
  

• Contoso.Utilities bijwerken naar de hoogste beschikbare versie en Fabrikam.WebApi naar versie 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.
  

• Pakketten bijwerken met bekende beveiligingsproblemen

  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.