Verweis auf NuGet-CLINuGet CLI reference

Die nuget-Befehlszeilenschnittstelle (CLI) nuget.exe bietet das gesamte Maß an nuget-Funktionen, um Pakete zu installieren, zu erstellen, zu veröffentlichen und zu verwalten, ohne dass Änderungen an den Projektdateien vorgenommen werden.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 zu verwenden, öffnen Sie ein Befehlsfenster oder eine bash-Shell, und führen Sie dann nuget aus, gefolgt vom Befehl und den entsprechenden Optionen, z nuget help pack . b. (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).

Diese Dokumentation spiegelt die neueste Version der nuget-CLI wider.This documentation reflects the latest version of the NuGet CLI. Führen Sie für den gewünschten Befehl aus, um genaue Informationen zu einer beliebigen Version zu erhalten, die Sie verwenden nuget help .For exact details for any given version that you're using, run nuget help for the desired command.

Informationen zur Verwendung grundlegender Befehle der nuget.exe-CLI finden Sie unter Installieren und Verwenden von Paketen mit der 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

Informationen dazu, wie Sie die nuget-CLI in der Paket-Manager-Konsole in Visual Studio verfügbar machen, finden Sie unter Verwenden 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

Genaue Informationen finden Sie unter Verfügbarkeit von Features .See feature availability for exact details.

  • Alle Befehle sind unter Windows verfügbar.All commands are available on Windows.
  • Alle Befehle funktionieren mit nuget.exe, die unter Mono ausgeführt werden, außer wenn für pack , und angegeben ist restore update .All commands work with nuget.exe running on Mono except where indicated for pack, restore, and update.
  • Die pack restore Befehle,, delete , locals und push sind auch unter Mac und Linux über die dotnet-CLI verfügbar.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 bei der Paket Erstellung, dem Paket Verbrauch und/oder dem Veröffentlichen eines Pakets auf einem Host:Available commands and applicability to package creation, package consumption, and/or publishing a package to a host:

Allgemeine BefehleCommon Commands Anwendbare RollenApplicable Roles NuGet-VersionNuGet Version BESCHREIBUNGDescription
packpack ErstellungCreation 2.7 und höher2.7+ Erstellt ein nuget-Paket aus einer- .nuspec oder-Projektdatei.Creates a NuGet package from a .nuspec or project file. Wenn Sie unter Mono ausführen, 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öffentlichungPublishing AllAll Veröffentlicht ein Paket in einer Paketquelle.Publishes a package to a package source.
configconfig AllAll AllAll Ruft nuget-Konfigurationswerte ab oder legt Sie fest.Gets or sets NuGet configuration values.
help or ?help or ? AllAll AllAll Zeigt Hilfe Informationen oder Hilfe zu einem Befehl an.Displays help information or help for a command.
localslocals NutzungConsumption 3.3 und höher3.3+ Listet die Speicherorte der Ordner " Global-Packages", " http-Cache" und " Temp " auf und löscht den Inhalt dieser Ordner.Lists locations of the global-packages, http-cache, and temp folders and clears the contents of those folders.
restorerestore NutzungConsumption 2.7 und höher2.7+ Stellt alle Pakete wieder her, auf die im verwendeten Paket Verwaltungs Format verwiesen wird.Restores all packages referenced by the package management format in use. Bei der Ausführung unter Mono wird das Wiederherstellen von Paketen mit dem packagereferenzierungsformat nicht unterstützt.When running on Mono, restoring packages using the PackageReference format is not supported.
setapikeysetapikey Veröffentlichen, VerbrauchPublishing, Consumption AllAll Speichert einen API-Schlüssel für eine bestimmte Paketquelle, wenn diese Paketquelle einen Schlüssel für den Zugriff benötigt.Saves an API key for a given package source when that package source requires a key for access.
specspec ErstellungCreation AllAll Generiert eine .nuspec Datei mithilfe von Token, 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 Anwendbare RollenApplicable Roles NuGet-VersionNuGet Version BESCHREIBUNGDescription
addadd VeröffentlichungPublishing 3.3 und höher3.3+ Fügt mithilfe des hierarchischen Layouts ein Paket zu einer nicht-http-Paketquelle hinzu.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öffentlichungPublishing AllAll Entfernt oder hebt die Auflistung eines Pakets aus einer Paketquelle auf.Removes or unlists a package from a package source.
initinit ErstellungCreation 3.3 und höher3.3+ Fügt mithilfe des hierarchischen Layouts Pakete aus einem Ordner einer Paketquelle hinzu.Adds packages from a folder to a package source using hierarchical layout.
installinstall NutzungConsumption AllAll Installiert ein Paket im aktuellen Projekt, ändert jedoch keine Projekte oder Verweis Dateien.Installs a package into the current project but does not modify projects or reference files.
listlist Verbrauch, vielleicht veröffentlichenConsumption, perhaps Publishing AllAll Zeigt Pakete aus einer angegebenen Quelle an.Displays packages from a given source.
mirrormirror VeröffentlichungPublishing Veraltet in 3.2 +Deprecated in 3.2+ Spiegelt ein Paket und seine Abhängigkeiten von einer Quelle in ein Zielrepository ein.Mirrors a package and its dependencies from a source to a target repository.
searchsearch NutzungConsumption 5.8 +5.8+ Durchsucht eine angegebene Quelle mithilfe der angegebenen Abfrage Zeichenfolge.Searches a given source using the query string provided.
sourcessources Verbrauch, VeröffentlichungConsumption, Publishing AllAll Verwaltet Paketquellen in Konfigurationsdateien.Manages package sources in configuration files.
updateupdate NutzungConsumption AllAll Aktualisiert die Pakete eines Projekts auf die neuesten verfügbaren Versionen.Updates a project's packages to the latest available versions. Wird nicht unterstützt, wenn Sie unter Mono ausgeführt wird.Not supported when running on Mono.

Verschiedene Befehle verwenden verschiedene Umgebungsvariablen.Different commands make use of various Environment variables.

Nuget-CLI-Befehle nach anwendbaren Rollen:NuGet CLI commands by applicable roles:

RoleRole BefehleCommands
NutzungConsumption config, help, install, list, locals, restore, search, setapikey, sources, updateconfig, help, install, list, locals, restore, search, setapikey, sources, update
ErstellungCreation config, help, init, pack, specconfig, help, init, pack, spec
VeröffentlichungPublishing add, config, delete, help, list, push, setapikey, sourcesadd, config, delete, help, list, push, setapikey, sources

Entwickler, die sich nur mit der Verwendung von Paketen beschäftigen, benötigen beispielsweise nur diese Teilmenge von nuget-Befehlen.Developers concerned only with consuming packages, for example, need only understand that subset of NuGet commands.

Hinweis

Bei Befehls Optionsnamen wird die Groß-/Kleinschreibung beachtetCommand option names are case-insensitive. Veraltete Optionen sind in diesem Verweis nicht enthalten, z NoPrompt . b. (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).