NuGet-CLI-ReferenzNuGet CLI reference

Die NuGet Command Line Interface (CLI), nuget.exe, enthält das Ausmaß des NuGet-Funktionen zu installieren, erstellen, veröffentlichen und -Pakete verwalten, ohne dass Änderungen an Projektdateien.The NuGet Command Line Interface (CLI), nuget.exe, provides the full extent of NuGet functionality to install, create, publish, and manage packages without making any changes to project files.

Um einen beliebigen Befehl verwenden, öffnen Sie ein Befehlsfenster oder bash-Shell, und führen Sie nuget wie z. B. gefolgt von den Befehl und die entsprechenden Optionen nuget help pack (zum Anzeigen der Hilfe zum Befehl "Pack").To use any command, open a command window or bash shell, then run nuget followed by the command and appropriate options, such as nuget help pack (to view help on the pack command).

In dieser Dokumentation gibt die neueste Version des NuGet-CLI.This documentation reflects the latest version of the NuGet CLI. Führen Sie für Informationen für jede Version, die Sie verwenden, nuget help für den gewünschten Befehl.For exact details for any given version that you're using, run nuget help for the desired command.

Erfahren, wie grundlegende Befehle mit den nuget.exe -Befehlszeilenschnittstelle finden Sie unter installieren und Verwenden von Paketen mithilfe von nuget.exe-CLI.To learn how to use basic commands with the nuget.exe CLI, see Install and use packages using the nuget.exe CLI.

Installieren von nuget.exeInstalling nuget.exe

WindowsWindows

Hinweis

Für die Ausführung von NuGet.exe 5.0 und höher ist .NET Framework 4.7.2 erforderlich.NuGet.exe 5.0 and later require .NET Framework 4.7.2 or later to execute.

  1. Besuchen Sie nuget.org/downloads, und wählen Sie NuGet 3.3 oder höher aus (2.8.6 ist nicht kompatibel mit Mono).Visit nuget.org/downloads and select NuGet 3.3 or higher (2.8.6 is not compatible with Mono). Die neueste Version wird immer empfohlen, und 4.1.0+ ist erforderlich, um Pakete in „nuget.org“ zu veröffentlichen.The latest version is always recommended, and 4.1.0+ is required to publish packages to nuget.org.
  2. Jeder Download ist direkt die Datei nuget.exe.Each download is the nuget.exe file directly. Weisen Sie Ihren Browser an, die Datei in einem Ordner Ihrer Wahl zu speichern.Instruct your browser to save the file to a folder of your choice. Die Datei ist kein Installationsprogramm; es wird nichts angezeigt, wenn Sie es direkt über den Browser ausführen.The file is not an installer; you won't see anything if you run it directly from the browser.
  3. Fügen Sie den Ordner, in dem Sie nuget.exe platziert haben, Ihrer Umgebungsvariablen PATH hinzu, um das CLI-Tool von überall aus verwenden zu können.Add the folder where you placed nuget.exe to your PATH environment variable to use the CLI tool from anywhere.

macOS/LinuxmacOS/Linux

Das Verhalten kann je nach Betriebssystemdistribution leicht variieren.Behaviors may vary slightly by OS distribution.

  1. Installieren Sie Mono 4.4.2 oder höher.Install Mono 4.4.2 or later.

  2. Führen Sie an einer Shelleingabeaufforderung folgenden Befehl aus:Execute the following command at a shell prompt:

    # Download the latest stable `nuget.exe` to `/usr/local/bin`
    sudo curl -o /usr/local/bin/nuget.exe https://dist.nuget.org/win-x86-commandline/latest/nuget.exe
    
  3. Erstellen Sie einen Alias, indem Sie das folgende Skript der entsprechenden Datei für Ihr Betriebssystem hinzufügen (in der Regel ~/.bash_aliases oder ~/.bash_profile):Create an alias by adding the following script to the appropriate file for your OS (typically ~/.bash_aliases or ~/.bash_profile):

    # Create as alias for nuget
    alias nuget="mono /usr/local/bin/nuget.exe"
    
  4. Laden Sie die Shell neu.Reload the shell. Testen Sie die Installation, indem Sie nuget ohne Parameter eingeben.Test the installation by entering nuget with no parameters. Die NuGet-CLI-Hilfe sollte angezeigt werden.NuGet CLI help should display.

Tipp

Um die NuGet-CLI in Visual Studio in der Paket-Manager-Konsole verfügbar zu machen, finden Sie unter mithilfe der nuget.exe-CLI in der Konsole.To make the NuGet CLI available within the Package Manager Console in Visual Studio, see Using the nuget.exe CLI in the console.

VerfügbarkeitAvailability

Finden Sie unter Verfügbarkeit von Features genaue Angaben.See feature availability for exact details.

  • Alle Befehle sind in Windows verfügbar.All commands are available on Windows.
  • Alle Befehle funktionieren bei nuget.exe unter Mono ausgeführt wird, wenn nicht anders für angegeben pack, restore, und update.All commands work with nuget.exe running on Mono except where indicated for pack, restore, and update.
  • Die pack, restore, delete, locals, und push Befehle stehen auch unter Mac und Linux über die Dotnet-CLI.The pack, restore, delete, locals, and push commands are also available on Mac and Linux through the dotnet CLI.

Befehle und AnwendbarkeitCommands and applicability

Verfügbare Befehle und Anwendbarkeit für die Erstellung des Pakets, paketverbrauch und/oder Veröffentlichen eines Pakets auf einem Host:Available commands and applicability to package creation, package consumption, and/or publishing a package to a host:

Häufig verwendete BefehleCommon Commands Anwendbaren ServerrollenApplicable Roles NuGet-VersionNuGet Version BeschreibungDescription
packpack ErstellenCreation 2.7+2.7+ Erstellt ein NuGet-Paket aus einer .nuspec oder einer Projektdatei.Creates a NuGet package from a .nuspec or project file. Wenn unter Mono ausgeführt wird, wird das Erstellen eines Pakets aus einer Projektdatei nicht unterstützt.When running on Mono, creating a package from a project file is not supported.
pushpush VeröffentlichenPublishing AlleAll Ein Paket veröffentlicht in eine Paketquelle.Publishes a package to a package source.
configconfig AlleAll AlleAll Übernimmt oder bestimmt die NuGet-Konfigurationswerte.Gets or sets NuGet configuration values.
help or ?help or ? AlleAll AlleAll Zeigt die Informationen oder Hilfe für einen Befehl Hilfe.Displays help information or help for a command.
localslocals VerbrauchConsumption 3.3+3.3+ Listet die Speicherorte der global-Packages, http-Cache, und Temp Ordner und löscht den Inhalt der Ordner.Lists locations of the global-packages, http-cache, and temp folders and clears the contents of those folders.
restorerestore VerbrauchConsumption 2.7+2.7+ Stellt alle Pakete, die auf die verwiesen wird durch das Format für die paketverwaltung verwendet.Restores all packages referenced by the package management format in use. Wenn unter Mono ausgeführt wird, wird das Wiederherstellen von Paketen, die das PackageReference-Format mit nicht unterstützt.When running on Mono, restoring packages using the PackageReference format is not supported.
setapikeysetapikey Veröffentlichung, NutzungPublishing, Consumption AlleAll Speichert einen API-Schlüssel für einen angegebenen Paketquelle aus, wenn diese Paketquelle für den Zugriff auf ein Schlüssel erforderlich ist.Saves an API key for a given package source when that package source requires a key for access.
specspec ErstellenCreation AlleAll Generiert eine .nuspec Datei, Token verwenden, wenn die Datei aus einem Visual Studio-Projekt generiert wird.Generates a .nuspec file, using tokens if generating the file from a Visual Studio project.
Sekundäre BefehleSecondary Commands Anwendbaren ServerrollenApplicable Roles NuGet-VersionNuGet Version BeschreibungDescription
addadd VeröffentlichenPublishing 3.3+3.3+ Fügt ein Paket mit einer nicht-HTTP-Paket-Datenquelle, die mithilfe von hierarchischen Anordnung an.Adds a package to a non-HTTP package source using hierarchical layout. Verwenden Sie für HTTP-Quellen Push.For HTTP sources, use push.
deletedelete VeröffentlichenPublishing AlleAll Entfernt oder hebt dessen Auflistung auf ein Paket aus der Paketquelle.Removes or unlists a package from a package source.
initinit ErstellenCreation 3.3+3.3+ Mithilfe hierarchischen Anordnung Paketquelle hinzugefügt Pakete aus einem Ordner.Adds packages from a folder to a package source using hierarchical layout.
installinstall VerbrauchConsumption AlleAll Installiert ein Paket in das aktuelle Projekt jedoch keine Projekte zu ändern oder Dateien zu verweisen.Installs a package into the current project but does not modify projects or reference files.
listlist Nutzung, z. B. veröffentlichenConsumption, perhaps Publishing AlleAll Werden Pakete aus einer angegebenen Quelle angezeigt.Displays packages from a given source.
mirrormirror VeröffentlichenPublishing Veraltet in 3.2 und höherDeprecated in 3.2+ Spiegelt ein Paket und seine Abhängigkeiten von einer Quelle in ein Zielrepository.Mirrors a package and its dependencies from a source to a target repository.
sourcessources Nutzung, die VeröffentlichungConsumption, Publishing AlleAll Verwaltet die Paketquellen in Konfigurationsdateien.Manages package sources in configuration files.
updateupdate VerbrauchConsumption AlleAll Die aktuellen verfügbaren Versionen aktualisiert eines Projekts Pakete.Updates a project's packages to the latest available versions. Wenn unter Mono unterstützt nicht.Not supported when running on Mono.

Stellen Sie andere Befehle verwenden verschiedener Umgebungsvariablen.Different commands make use of various Environment variables.

NuGet-CLI-Befehle nach anwendbaren Serverrollen:NuGet CLI commands by applicable roles:

RolleRole BefehleCommands
VerbrauchConsumption config, help, install, list, locals, restore, setapikey, sources, updateconfig, help, install, list, locals, restore, setapikey, sources, update
ErstellenCreation config, help, init, pack, specconfig, help, init, pack, spec
VeröffentlichenPublishing add, config, delete, help, list, push, setapikey, sourcesadd, config, delete, help, list, push, setapikey, sources

Entwickler, die nur mit der Nutzen von Paketen, befassen müssen z. B. nur diese Teilmenge von NuGet-Befehle verstehen.Developers concerned only with consuming packages, for example, need only understand that subset of NuGet commands.

Hinweis

Befehl Optionsnamen Groß-und Kleinschreibung.Command option names are case-insensitive. Optionen, die veraltet sind nicht befinden sich in dieser Referenz, z. B. NoPrompt (ersetzt durch NonInteractive) und Verbose (ersetzt durch Verbosity).Options that are deprecated are not included in this reference, such as NoPrompt (replaced by NonInteractive) and Verbose (replaced by Verbosity).