Verwalten von Paketen mit der nuget.exe-CLIManage packages using the nuget.exe CLI

Mit dem CLI-Tool können Sie auf einfache Weise NuGet-Pakete in Projekten und Projektmappen aktualisieren und wiederherstellen.The CLI tool allows you to easily update and restore NuGet packages in projects and solutions. Dieses Tool bietet alle Funktionen von NuGet unter Windows und stellt darüber hinaus die meisten Features für Mac und Linux unter Mono bereit.This tool provides all NuGet capabilities on Windows, and also provides most features on Mac and Linux when running under Mono.

Die nuget.exe-CLI ist für .NET Framework-Projekte und Projekte im Nicht-SDK-Format vorgesehen (z.B. Projekte im Nicht-SDK-Format, die auf .NET-Standardbibliotheken ausgerichtet sind).The nuget.exe CLI is for your .NET Framework project and non-SDK-style projects (for example, a non-SDK style project that targets .NET Standard libraries). Wenn Sie ein Nicht-SDK-Projekt verwenden, das zu PackageReference migriert wurde, verwenden Sie stattdessen die dotnet-CLI.If you are using a non-SDK-style project that has been migrated to PackageReference, use the dotnet CLI instead. Die nuget.exe-CLI erfordert eine Datei packages.config für Paketverweise.The nuget.exe CLI requires a packages.config file for package references.

Hinweis

In den meisten Szenarien wird empfohlen, Nicht-SDK-Projekte mit Verwendung von packages.config zu PackageReference zu migrieren. Anschließend können Sie anstelle der dotnet-CLI die nuget.exe-CLI verwenden.In most scenarios, we recommend migrating non-SDK-style projects that use packages.config to PackageReference, and then you can use the dotnet CLI instead of the nuget.exe CLI. Für C++- und ASP.NET-Projekte ist momentan keine Migration verfügbar.Migration is not currently available for C++ and ASP.NET projects.

Dieser Artikel zeigt die grundlegende Verwendung einiger der gängigsten nuget.exe-CLI-Befehle.This article shows you basic usage for a few of the most common nuget.exe CLI commands. Bei den meisten dieser Befehle sucht das CLI-Tool nach einer Projektdatei im aktuellen Verzeichnis, sofern keine Projektdatei im Befehl angegeben ist.For most of these commands, the CLI tool looks for a project file in the current directory, unless a project file is specified in the command. Eine vollständige Liste der verfügbaren Befehle und Argumente finden Sie in der Referenz zur nuget.exe-CLI.For a complete list of commands and the arguments you may use, see the nuget.exe CLI reference.

VoraussetzungenPrerequisites

  • Installieren Sie die nuget.exe-CLI, indem Sie sie von nuget.org herunterladen, die .exe-Datei in einen geeigneten Ordner speichern und den Ordner der Umgebungsvariable PATH hinzufügen.Install the nuget.exe CLI by downloading it from nuget.org, saving that .exe file to a suitable folder, and adding that folder to your PATH environment variable.

Installieren eines PaketsInstall a package

Mit dem Befehl install wird ein Projekt heruntergeladen und in einem Projekt installiert. Die Installation erfolgt standardmäßig im aktuellen Ordner, unter Verwendung der angegebenen Paketquellen.The install command downloads and installs a package into a project, defaulting to the current folder, using specified package sources. Installieren Sie neue Pakete im Ordner packages in Ihrem Projektstammverzeichnis.Install new packages into the packages folder in your project root directory.

Wichtig

Der install-Befehl nimmt keine Änderungen an einer Projektdatei oder packages.config vor. Damit ähnelt er restore darin, dass Pakete nur zum Datenträger hinzugefügt, aber die Abhängigkeiten eines Projekts nicht geändert werden.The installcommand does not modify a project file or packages.config; in this way it's similar to restore in that it only adds packages to disk but does not change a project's dependencies. Um eine Abhängigkeit hinzuzufügen, fügen Sie ein Paket entweder über den Paket-Manager oder die Konsole in Visual Studio hinzu. Als dritte Möglichkeit können Sie packages.config ändern und anschließend install oder restore ausführen.To add a dependency, either add a package through the Package Manager UI or Console in Visual Studio, or modify packages.config and then run either install or restore.

  1. Öffnen Sie eine Befehlszeile, und wechseln Sie zu dem Verzeichnis, das Ihre Projektdatei enthält.Open a command line and switch to the directory that contains your project file.

  2. Verwenden Sie den folgenden Befehl, um ein NuGet-Paket im Ordner packages zu installieren.Use the following command to install a NuGet package to the packages folder.

    nuget install <packageID> -OutputDirectory packages
    

    Um das Newtonsoft.json-Paket im Ordner packages zu installieren, verwenden Sie den folgenden Befehl:To install the Newtonsoft.json package to the packages folder, use the following command:

    nuget install Newtonsoft.Json -OutputDirectory packages
    

Alternativ können Sie den folgenden Befehl verwenden, um ein NuGet-Paket unter Verwendung einer vorhandenen packages.config-Datei im Ordner packages zu installieren.Alternatively, you can use the following command to install a NuGet package using an existing packages.config file to the packages folder. Hierdurch wird das Paket nicht zu Ihren Projektabhängigkeiten hinzugefügt, sondern lokal installiert.This does not add the package to your project dependencies, but installs it locally.

nuget install packages.config -OutputDirectory packages

Installieren einer bestimmten PaketversionInstall a specific version of a package

Wenn bei Verwendung des Befehls install keine Version angegeben wird, installiert NuGet die neueste Version des Pakets.If the version is not specified when you use the install command, NuGet installs the latest version of the package. Sie können auch eine bestimmte Version eines Pakets installieren:You can also install a specific version of a Nuget package:

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

Verwenden Sie beispielsweise diesen Befehl, um Version 12.0.1 des Newtonsoft.json-Pakets hinzuzufügen:For example, to add version 12.0.1 of the Newtonsoft.json package, use this command:

nuget install Newtonsoft.Json -Version 12.0.1

Weitere Informationen zu Einschränkungen und Verhalten von install finden Sie unter Installieren eines Pakets.For more information on the limitations and behavior of install, see Install a package.

Entfernen eines PaketsRemove a package

Um ein Paket oder mehrere Pakete zu entfernen, löschen Sie die betreffenden Pakete aus dem Ordner packages.To delete one or more packages, delete the packages you want to remove from the packages folder.

Wenn Sie Pakete erneut installieren möchten, verwenden Sie den Befehl restore oder install.If you want to reinstall packages, use the restore or install command.

Auflisten von PaketenList packages

Sie können über den Befehl list eine Liste der Pakete einer angegebenen Quelle anzeigen.You can display a list of packages from a given source using the list command. Verwenden Sie die Option -Source, um die Suche einzuschränken.Use the -Source option to restrict the search.

nuget list -Source <source>

Listen Sie beispielsweise die Pakete im Ordner packages auf.For example, list packages in the packages folder.

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

Wenn Sie einen Suchbegriff verwenden, umfasst die Suche die Namen von Paketen, Tags und Paketbeschreibungen.If you use a search term, the search includes names of packages, tags, and package descriptions.

nuget list <search term>

Aktualisieren eines einzelnen PaketsUpdate an individual package

NuGet installiert die neueste Version eines Pakets, wenn bei Verwendung des install-Befehls keine Version angegeben wird.NuGet installs the latest version of the package when you use the install command unless you specify the package version.

Aktualisieren aller PaketeUpdate all packages

Verwenden Sie den Befehl update, um alle Pakete zu aktualisieren.Use the update command to update all packages. Alle Pakete in einem Projekt werden (unter Verwendung von packages.config) auf die neuesten verfügbaren Versionen aktualisiert.Updates all packages in a project (using packages.config) to their latest available versions. Es wird empfohlen, restore vor update auszuführen.It is recommended to run restore before running update.

nuget update

Pakete wiederherstellenRestore packages

Verwenden Sie zum Wiederherstellen den Befehl restore. Mit diesem Befehl werden alle Pakete heruntergeladen und installiert, die im Ordner packages fehlen.Use the restore command, which downloads and installs any packages missing from the packages folder.

Verwenden Sie für Projekte, die zu PackageReference migriert wurden, stattdessen msbuild -t:restore zum Wiederherstellen von Paketen.For projects migrated to PackageReference, use msbuild -t:restore to restore packages instead.

restore fügt Pakete nur zum Datenträger hinzu, die Abhängigkeiten eines Projekts werden nicht geändert.restore only adds packages to disk but does not change a project's dependencies. Um Projektabhängigkeiten wiederherzustellen, ändern Sie packages.config, und verwenden Sie anschließend den Befehl restore.To restore project dependencies, modify packages.config, then use the restore command.

Öffnen Sie wie bei anderen nuget.exe-CLI-Befehlen zunächst eine Befehlszeile, und wechseln Sie zu dem Verzeichnis, das die Projektdatei enthält.As with the other nuget.exe CLI commands, first open a command line and switch to the directory that contains your project file.

Wiederherstellen eines Pakets mit restore:To restore a package using restore:

nuget restore MySolution.sln

Abrufen der CLI-VersionGet the CLI version

Verwenden Sie diesen Befehl:Use this command:

nuget help

Die erste Zeile der Hilfeausgabe zeigt die Version an.The first line in the help output shows the version. Um nicht nach oben scrollen zu müssen, verwenden Sie stattdessen nuget help | more.To avoid scrolling up, use nuget help | more instead.