Freigeben über

dotnet-Paketupdate

Dieser Artikel bezieht sich auf: ✔️ .NET 10 SDK und höhere Versionen

Name

dotnet package update – Aktualisieren von referenzierten Paketen in einem Projekt.

Zusammenfassung

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

dotnet package update -h|--help

Description

Mit dem dotnet package update Befehl werden pakete aktualisiert, die von Projekten verwendet werden. Wenn NuGetAudit aktiviert ist, kann es auch versuchen, Updatepakete mit bekannten Sicherheitslücken auf feste Versionen automatisch zu aktualisieren.

Warnungen als Fehler

dotnet package update führt implizite Wiederherstellungen aus, um zu überprüfen, ob das resultierende Paketdiagramm fehlerfrei ist. Die Verwendung --vulnerable führt auch eine implizite Wiederherstellung aus, um NuGetAudit-Warnungen zu finden. Wenn ihr Projekt jedoch Warnungen zur Wiederherstellung verwendet WarningsAsErrors oder TreatWarningsAsErrors, kann die Wiederherstellung von NuGet dazu führen, dass die Wiederherstellung fehlschlägt, hindert das Update daran, das Update abzuschließen.

Es wird empfohlen, MSBuild-Bedingungen und Umgebungsvariablen als Problemumgehung zu nutzen, bis diese Featureanforderung implementiert ist. Legen Sie <TreatWarningsAsErrors Condition=" '$(CustomCondition)' == ''>true</TreatWarningsAsErrors> beispielsweise in Ihrem Projekt und dann auf den meisten Linux- und Mac-Shells fest, die Sie ausführen CustomCondition=true dotnet package updatekönnen. Auf der Windows-Eingabeaufforderung und PowerShell müssen Sie die Umgebungsvariable festlegen, das Dotnet-Paketupdate ausführen und dann die Umgebungsvariable als drei separate Befehle aufheben.

Arguments

  • packages

    Eine optionale Liste der zu aktualisierenden Pakete. Wenn keine Pakete bereitgestellt werden, versucht der Befehl, alle Pakete zu aktualisieren, auf die vom Projekt verwiesen wird. Pakete können optional ein Paketname sein, gefolgt von einer @ und einer Versionsnummer. Zum Beispiel: dotnet package update Contoso.Utilities oder dotnet package update Contoso.Utilities@3.2.1. Wenn keine Version bereitgestellt wird, wird die höchste Version gefunden, die in den konfigurierten Paketquellen verfügbar ist.

Options

  • --interactive

    Ermöglicht dem Befehl, anzuhalten und auf Benutzereingaben oder Aktionen zu warten. Beispielsweise, um die Authentifizierung abzuschließen.

  • --project <path>

    Das Projekt, in dem Pakete aktualisiert werden sollen. Wenn ein Verzeichnis bereitgestellt wird, sucht es nach Projekt- und Lösungsdateien im Verzeichnis. Standardmäßig wird das aktuelle Arbeitsverzeichnis verwendet.

  • -v|--verbosity <LEVEL>

    Legt den Ausführlichkeitsgrad für den Befehl fest. Zulässige Werte sind q[uiet], m[inimal], n[ormal], d[etailed] und diag[nostic]. Weitere Informationen finden Sie unter LoggerVerbosity.

  • --vulnerable

    Wenn beim Wiederherstellen Pakete als bekannte Sicherheitsrisiken gemeldet werden, aktualisiert dieser Befehl diese Pakete. Wenn Sie diese Option verwenden, werden Pakete auf die niedrigste Version aktualisiert, die höher als die aktuell referenzierte Version ist, die keine bekannten Sicherheitsrisiken aufweist.

  • -?|-h|--help

    Gibt eine Beschreibung zur Verwendung des Befehls aus.

Examples

  • Aktualisieren aller Pakete im Projekt auf die höchste verfügbare Version

    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.

  • Aktualisieren von Contoso.Utilities auf die höchste verfügbare Version und Fabrikam.WebApi auf 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.

  • Aktualisieren von Paketen mit bekannten Sicherheitsrisiken

    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