Verwalten von NuGet-Paketen mit der NuGet CLI

Sie können das nuget.exe CLI-Tool verwenden, um NuGet-Pakete in Visual Studio-Projekten und -Lösungen zu verwalten. In diesem Artikel werden die am häufigsten verwendeten NuGet CLI-Befehle zum Verwalten von NuGet-Paketen beschrieben. All diese Befehle funktionieren unter Windows, und die meisten arbeiten auf Mac und unter Linux mit Mono.

Die NuGet CLI wird für .NET Framework- und Nicht-SDK-Stilprojekte ausgeführt, z. B. Nicht-SDK-Stilprojekte, die auf .NET Standardbibliotheken abzielen. Die NuGet CLI-Befehle können ein Projekt packages.config Datei verwenden, die Paketverweise auflistet. Verwenden Sie für Projekte im Nicht-SDK-Stil, die PackageReference anstelle von packages.config für Paketverweise verwenden, die dotnet CLI.

Für die meisten Befehle verwendet das NuGet CLI-Tool das aktuelle Verzeichnis, es sei denn, Sie geben einen anderen Speicherort im Befehl an. Um NuGet CLI-Befehle auszuführen, öffnen Sie eine Befehlszeile, und wechseln Sie zu dem Verzeichnis, das Ihre Projektdatei enthält.

Eine vollständige Liste der Befehle und deren Argumente finden Sie in der NuGet CLI-Referenz.

Voraussetzungen

Laden Sie die NuGet CLI von nuget.org herunter. Speichern Sie die nuget.exe Datei in einem geeigneten Verzeichnis, und stellen Sie sicher, dass sich das Verzeichnis in Ihrer PATH-Umgebungsvariable befindet.

Um Ihre NuGet CLI-Version zu ermitteln, öffnen Sie eine Befehlszeile, und führen Sie aus nuget help, oder um zu vermeiden, dass Sie nach oben scrollen müssen, verwenden Sie nuget help | more. Die erste Zeile in der Hilfeausgabe zeigt die Version an.

Installieren eines Pakets

Der NuGet CLI-Installationsbefehl lädt die angegebenen NuGet-Pakete herunter und installiert sie.

Verwenden Sie die -OutputDirectory Option zum Installieren von Paketen in einem bestimmten Verzeichnis. Wenn Sie kein Ausgabeverzeichnis angeben, install wird das aktuelle Verzeichnis verwendet.

nuget install <packageID | configFilePath> -OutputDirectory <outputDirectory>

Verwenden Sie beispielsweise den folgenden Befehl, um das Paket im Unterverzeichnis der Newtonsoft.jsonPakete zu installieren:

nuget install Newtonsoft.Json -OutputDirectory packages

Anstatt ein zu installierenes Paket anzugeben, können Sie eine vorhandene packages.config Datei im aktuellen oder einem anderen Verzeichnis angeben. Mit install dem Befehl werden alle pakete installiert, die in der dateipackages.config aufgeführt sind.

nuget install packages.config

Mit dem folgenden Befehl werden beispielsweise alle pakete installiert, die in packages.config im Unterverzeichnis "config " im Unterverzeichnis "packages " aufgeführt sind:

nuget install config\packages.config -OutputDirectory packages

Installieren einer bestimmten Paketversion

Der install Befehl installiert die neueste Version eines Pakets, es sei denn, Sie geben eine andere Version an. Verwenden Sie die -Version Folgende Option, um eine bestimmte Version eines Pakets zu installieren:

nuget install <packageID | configFilePath> -Version <version>

Um beispielsweise Version 12.0.1 des Newtonsoft.json Pakets zu installieren, verwenden Sie Folgendes:

nuget install Newtonsoft.Json -Version 12.0.1

Auflisten von Paketen

Verwenden Sie den Listenbefehl , um eine Liste der pakete anzuzeigen, die in den Paketordnern installiert sind. Verwenden Sie die -Source Option, um die Liste einzuschränken.

nuget list -Source <source>

Wenn Sie beispielsweise Pakete im Unterverzeichnis "Pakete" von MyProject auflisten möchten, verwenden Sie Folgendes:

nuget list -Source C:\Users\%USERNAME%\source\repos\MyProject\packages

Sie können auch einen Suchbegriff verwenden, um nach Paketnamen, Tags oder Beschreibungen zu suchen:

nuget list <"search term"> -Source <source>

Alle Pakete aktualisieren

Verwenden Sie den Befehl "Aktualisieren ", um alle Pakete in einem Projekt packages.config Datei auf die neuesten verfügbaren Versionen zu aktualisieren. Es ist am besten, restore auszuführen, bevor Sie update ausführen.

nuget update

Entfernen eines Pakets

Um ein Paket zu entfernen, löschen Sie dieses Paket aus dem Projektordner. Verwenden Sie die restore Befehle, install um Pakete neu zu installieren.

Durch das Löschen von Paketen vom Datenträger werden die Dateien Projekt, packages.configoder NuGet.Config nicht aktualisiert. Die beste Möglichkeit zum Entfernen von Paketen ist die Visual Studio Package Manager-Benutzeroberfläche oder die Paket-Manager-Konsole.

Pakete wiederherstellen

Der NuGet CLI-Wiederherstellungsbefehl lädt alle fehlenden Pakete herunter und installiert sie. Der Befehl funktioniert für Projekte, die entweder PackageReference oder packages.config für Paketverweise verwenden.

Wie installfolgt, fügt der restore Befehl nur Pakete auf dem Datenträger hinzu, ändert aber nicht die Projektdatei oder packages.config. Um Projektabhängigkeiten hinzuzufügen, verwenden Sie die Visual Studio Package Manager-Benutzeroberfläche oder -Konsole.

Führen Sie zum Wiederherstellen von Paketen den folgenden Befehl aus:

nuget restore <projectPath>

Der restore Befehl verwendet eine Lösungsdatei oder eine package.config Datei im angegebenen Projektpfad.

Um beispielsweise alle Pakete für MySolution.sln im aktuellen Verzeichnis wiederherzustellen, führen Sie Folgendes aus:

nuget restore MySolution.sln

Weitere Informationen finden Sie unter "Wiederherstellen von Paketen".

Nächste Schritte

• NuGet CLI-Referenz
• Installieren und Verwalten von Paketen in Visual Studio mithilfe des NuGet-Paket-Managers
• Migrieren von packages.config zu PackageReference
• Verwalten von Paketen mit der dotnet CLI