Verwalten von NuGet-Paketen mit der NuGet CLI

Sie können die nuget.exe Befehlszeilenschnittstelle (CLI) 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 auf Windows, und die meisten arbeiten unter macOS 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 den aktuellen Ordner, es sei denn, Sie geben einen anderen Speicherort im Befehl an. Um NuGet CLI-Befehle auszuführen, öffnen Sie ein Befehlszeilenprogramm, und wechseln Sie zu dem Ordner, der Ihre Projektdatei enthält.

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

Voraussetzungen

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

Um Ihre NuGet CLI-Version zu überprüfen, öffnen Sie ein Befehlszeilenprogramm, und führen Sie es 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-Befehl install lädt die angegebenen NuGet-Pakete herunter und installiert sie.

Verwenden Sie die -OutputDirectory Option zum Installieren von Paketen in einem bestimmten Ordner. Wenn Sie keinen Ausgabeordner angeben, install wird der aktuelle Ordner verwendet.

nuget install <package-ID | configuration-file-path> -OutputDirectory <output-folder>

Verwenden Sie beispielsweise den folgenden Befehl, um das Newtonsoft.json Paket im Unterordner "Pakete " zu installieren:

nuget install Newtonsoft.Json -OutputDirectory packages

Anstatt ein zu installierenes Paket anzugeben, können Sie eine vorhandene packages.config Datei im aktuellen Ordner oder einem anderen Ordner 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 Konfigurationsunterordner des aktuellen Ordners aufgeführt sind. Der Befehl installiert die Pakete im Paketordner .

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 <package-ID> -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

Pakete auflisten

Verwenden Sie den search Befehl, um grundlegende Informationen zu Paketen an einer angegebenen Quelle anzuzeigen.

nuget search -Source <source>

Wenn Sie beispielsweise Pakete im Unterordner von MyProject auflisten möchten, verwenden Sie den folgenden Befehl:

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

Sie können auch Suchbegriffe angeben, um die Ergebnisse durch Paketnamen, Tags oder Beschreibungen einzuschränken:

nuget search <search-terms> -Source <source>

Alle Pakete aktualisieren

Verwenden Sie den update Befehl, um alle Pakete in einem Projekt packages.config Datei auf die neuesten verfügbaren Versionen zu aktualisieren. Verwenden Sie für <configuration-file-path> den Pfad zu Ihrer Datei packages.config.

nuget update <configuration-file-path>

Es ist am besten, restore auszuführen, bevor Sie update ausführen. Anschließend enthält der update Befehl Informationen zu den verwendeten Paketversionen. Mit diesen Informationen können Abhängigkeiten ordnungsgemäß aufgelöst werden.

Entfernen eines Pakets

Um ein Paket zu entfernen, können Sie dieses Paket aus dem Projektordner löschen. 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 Verwendung der Visual Studio Paket-Manager UI oder Paket-Manager Console.

Pakete wiederherstellen

Der Befehl NuGet CLI restore 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. Die Projektdatei oder packages.config Datei wird nicht geändert. Um Projektabhängigkeiten hinzuzufügen, verwenden Sie die Visual Studio Paket-Manager UI oder Konsole.

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

nuget restore <project-path>

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

Um beispielsweise alle Pakete für MySolution.slnx im aktuellen Verzeichnis wiederherzustellen, führen Sie den folgenden Befehl aus:

nuget restore MySolution.slnx

Weitere Informationen finden Sie unter "Wiederherstellen von Paketen".

Verwandte Inhalte

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