Installieren und Verwalten von Paketen mit der dotnet-CLIInstall and manage packages using the dotnet CLI

Mit dem CLI-Tool können Sie auf einfache Weise NuGet-Pakete in Projekten und Lösungen installieren, deinstallieren und aktualisieren.The CLI tool allows you to easily install, uninstall, and update NuGet packages in projects and solutions. Es kann unter Windows, Mac OS X und Linux ausgeführt werden.It runs on Windows, Mac OS X, and Linux.

Die dotnet-CLI ist für die Verwendung in .NET Core- und .NET Standard-Projekten (Projekte im SDK-Stil) und für andere Projekte im SDK-Stil vorgesehen (z.B. ein Projekt im SDK-Stil, das auf .NET Framework abzielt).The dotnet CLI is for use in your .NET Core and .NET Standard project (SDK-style project types), and for any other SDK-style projects (for example, an SDK-style project that targets .NET Framework). Weitere Informationen finden Sie unter SDK-Attribute.For more information, see SDK attribute.

Dieser Artikel zeigt die grundlegende Verwendung einiger der gängigsten dotnet-CLI-Befehle.This article shows you basic usage for a few of the most common dotnet CLI commands. Bei den meisten dieser Befehle sucht das CLI-Tool nach einer Projektdatei im aktuellen Verzeichnis, sofern keine Projektdatei im Befehl angegeben ist (die Projektdatei ist ein optionaler Schalter).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 (the project file is an optional switch). Eine vollständige Liste der verfügbaren Befehle und Argumente finden Sie unter .NET Core-CLI-Tools.For a complete list of commands and the arguments you may use, see the .NET Core command-line interface (CLI) tools.

Erforderliche KomponentenPrerequisites

  • Das .NET Core SDK, das das Befehlszeilentool dotnet bietet.The .NET Core SDK, which provides the dotnet command-line tool. Ab Visual Studio 2017 wird die dotnet-CLI automatisch mit jeder .NET Core-bezogenen Workload installiert.Starting in Visual Studio 2017, the dotnet CLI is automatically installed with any .NET Core related workloads.

Installieren eines PaketsInstall a package

Über dotnet add package wird ein Paketverweis auf die Projektdatei hinzugefügt, anschließend wird dotnet restore ausgeführt, um das Paket zu installieren.dotnet add package adds a package reference to the project file, then runs dotnet restore to install the package.

  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 folgenden Befehl, um ein NuGet-Paket zu installieren:Use the following command to install a Nuget package:

    dotnet add package <PACKAGE_NAME>
    

    Verwenden Sie beispielsweise zum Installieren des Newtonsoft.Json-Pakets den folgenden Befehl:For example, to install the Newtonsoft.Json package, use the following command

    dotnet add package Newtonsoft.Json
    
  3. Sehen Sie sich nach Ausführung des Befehls die Projektdatei an, um sicherzustellen, dass das Paket installiert wurde.After the command completes, look at the project file to make sure the package was installed.

    Sie können die .csproj-Datei öffnen, um den hinzugefügten Verweis anzuzeigen:You can open the .csproj file to see the added reference:

    <ItemGroup>
    <PackageReference Include="Newtonsoft.Json" Version="12.0.1" />
    </ItemGroup>
    

Installieren einer bestimmten PaketversionInstall a specific version of a package

Wenn keine Version angegeben wird, installiert NuGet die neueste Version des Pakets.If the version is not specified, NuGet installs the latest version of the package. Sie können den Befehl dotnet add package verwenden, um eine bestimmte Version eines NuGet-Pakets zu installieren:You can also use the dotnet add package command to install a specific version of a Nuget package:

dotnet add package <PACKAGE_NAME> -v <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:

dotnet add package Newtonsoft.Json -v 12.0.1

Auflisten von PaketverweisenList package references

Sie können über den Befehl dotnet list package die Paketverweise für Ihr Projekt auflisten.You can list the package references for your project using the dotnet list package command.

dotnet list package

Entfernen eines PaketsRemove a package

Verwenden Sie den Befehl dotnet remove package, um einen Paketverweis aus der Projektdatei zu entfernen.Use the dotnet remove package command to remove a package reference from the project file.

dotnet remove package <PACKAGE_NAME>

Verwenden Sie beispielsweise zum Entfernen des Newtonsoft.Json-Pakets den folgenden Befehl:For example, to remove the Newtonsoft.Json package, use the following command

dotnet remove package Newtonsoft.Json

Aktualisieren eines PaketsUpdate a package

NuGet installiert die neueste Version eines Pakets, wenn bei Verwendung des dotnet add package-Befehls keine Version angegeben wird (Schalter -v).NuGet installs the latest version of the package when you use the dotnet add package command unless you specify the package version (-v switch).

Pakete wiederherstellenRestore packages

Verwenden Sie den Befehl dotnet restore, der Pakete wiederherstellt, die in der Projektdatei aufgelistet sind (siehe PackageReference).Use the dotnet restore command, which restores packages listed in the project file (see PackageReference). In .NET Core 2.0 und höher erfolgt die Wiederherstellung automatisch mit dotnet build und dotnet run.With .NET Core 2.0 and later, restore is done automatically with dotnet build and dotnet run. Ab NuGet 4.0 wird derselbe Code ausgeführt wie für nuget restore.As of NuGet 4.0, this runs the same code as nuget restore.

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

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

dotnet restore