Freigeben über

Befehl aktualisieren (NuGet CLI)

  • Artikel

Gilt für: Paketverbrauch • Unterstützte Versionen: alle

Alle Pakete in einem Projekt werden (unter Verwendung von packages.config) auf die neuesten verfügbaren Versionen aktualisiert. Es wird empfohlen, 'restore' auszuführen, bevor Sie die update ausführen. (Verwenden Sie zum Aktualisieren eines einzelnen Pakets nuget install ohne Angabe einer Versionsnummer, in diesem Fall installiert NuGet die neueste Version.)

Hinweis: update Funktioniert nicht mit der CLI, die unter Mono (Mac OSX oder Linux) ausgeführt wird, oder wenn Sie das PackageReference-Format verwenden.

Der update Befehl aktualisiert auch Assemblyverweise in der Projektdatei, vorausgesetzt, diese Verweise sind bereits vorhanden. Wenn ein aktualisiertes Paket über eine hinzugefügte Assembly verfügt, wird kein neuer Verweis hinzugefügt. Neue Paketabhängigkeiten haben auch keine Assemblyverweise hinzugefügt. Um diese Vorgänge als Teil eines Updates einzuschließen, aktualisieren Sie das Paket in Visual Studio mithilfe der Paket-Manager UI oder der Paket-Manager Konsole.

Dieser Befehl kann auch verwendet werden, um nuget.exe selbst mithilfe der -self-Flag zu aktualisieren.

Verbrauch

nuget update <configPath> [options]

wobei <configPath> entweder eine packages.config- oder eine Lösungsdatei angibt, in der die Abhängigkeiten des Projekts aufgelistet sind.

Optionen

  • -ConfigFile

    Die NuGet-Konfigurationsdatei. Wenn nicht angegeben, %AppData%\NuGet\NuGet.Config (Windows) oder ~/.nuget/NuGet/NuGet.Config~/.config/NuGet/NuGet.Config (Mac/Linux) wird verwendet.

  • -DependencyVersion [Lowest, HighestPatch, HighestMinor, Highest, Ignore]

    Die Version der zu verwendenden Abhängigkeitspakete, die eine der folgenden sein kann:

    • Lowest (Standard): die niedrigste Version
    • HighestPatch: die Version mit dem niedrigsten Maximum, dem niedrigsten Minimum und dem höchsten Patch
    • HighestPatch: die Version mit dem niedrigsten Maximum, dem höchsten Minimum und dem höchsten Patch
    • Höchste Version: die höchste Version
    • Ignorieren: Es werden keine Abhängigkeitspakete verwendet

  • -FileConflictAction [PromptUser, Overwrite, Ignore]

    Gibt die Standardaktion an, wenn eine Datei aus einem Paket bereits imZielprojekt vorhanden ist. Setzen Sie den Wert auf Overwrite, um Dateien immer zu überschreiben. Legen Sie fest, Ignore dass Dateien übersprungen werden sollen.

    Die PromptUser Aktion, der Standardwert, fordert jede widersprüchliche Datei auf, es sei dennOverwriteAll, sie IgnoreAll wird bereitgestellt, die für alle Standard erneuten Dateien gilt.

  • -ForceEnglishOutput

    (3.5+) Erzwingt die Ausführung der Anwendung mithilfe einer invarianten Kultur, die auf Englisch basiert.

  • -?|-help

    Druckt Hilfeinformationen für den Befehl.

  • -Id

    Gibt eine Liste der zu aktualisierenden Paket-IDs an.

  • -MSBuildPath

    (4,0+) Gibt den Pfad von MSBuild an, der mit dem Befehl verwendet werden soll, und hat Vorrang vor -MSBuildVersion.

  • -MSBuildVersion

    (3.2+) Gibt die Version von MSBuild an, die mit diesem Befehl verwendet werden soll. Unterstützte Werte sind 4, 12, 14, 15.1, 15.3, 15.4, 15.5, 15.6, 15.7, 15.8, 15.9. Standardmäßig wird "MSBuild" in Ihrem Pfad ausgewählt, andernfalls wird standardmäßig die höchste installierte Version von MSBuild verwendet.

  • -NonInteractive

    Fordert nicht zu Eingaben oder Bestätigungen des Benutzers auf.

  • -PreRelease

    Ermöglicht das Aktualisieren auf Vorabversionen. Dieses Flag ist nicht erforderlich, wenn pakete aktualisiert werden, die bereits installiert sind.

  • -RepositoryPath

    Gibt den Ordner an, in dem Pakete installiert sind.

  • -Safe

    Gibt an, dass nur Updates mit der höchsten Verfügbaren Version innerhalb derselben Haupt- und Nebenversion wie das installierte Paket installiert werden.

  • -Self

    Aktualisieren Sie nuget.exe auf die neueste Version. -Source kann verwendet werden, aber alle anderen Argumente werden ignoriert. Wenn keine Quelle angegeben wird, wird unabhängig von nuget.org Einstellungen NuGet.Config nach Aktualisierungen durchsucht.

  • -Source

    Gibt die Liste der Paketquellen (als URLs) an, die für die Updates verwendet werden sollen. Wenn sie weggelassen wird, verwendet der Befehl die in Konfigurationsdateien bereitgestellten Quellen unter "Allgemeine NuGet-Konfigurationen".

  • -Verbosity [normal|quiet|detailed]

    Gibt an, wie viele Details in der Ausgabe angezeigt werden: normal (der Standard), quiet oder detailed.

  • -Version

    Gibt bei Verwendung mit einer Paket-ID die Version des zu aktualisierenden Pakets an.

Weitere Informationen finden Sie unter Umgebungsvariablen

Beispiele

nuget update

# update packages installed in solution.sln, using MSBuild version 14.0 to load the solution and its project(s).
nuget update solution.sln -MSBuildVersion 14

nuget update -safe

nuget update -self