Freigeben über

NuGet CLI-Referenz

Die NuGet-Befehlszeilenschnittstelle (CLI) nuget.exebietet das vollständige Ausmaß der NuGet-Funktionalität zum Installieren, Erstellen, Veröffentlichen und Verwalten von Paketen, ohne Änderungen an Projektdateien vorzunehmen.

Um einen beliebigen Befehl zu verwenden, öffnen Sie ein Befehlsfenster oder eine Bash-Shell, und führen Sie nuget dann gefolgt von dem Befehl und den entsprechenden Optionen aus, z nuget help pack . B. (um Hilfe zum Packbefehl anzuzeigen).

Diese Dokumentation spiegelt die neueste Version der NuGet CLI wider. Wenn Sie genaue Details für jede version benötigen, die Sie verwenden, führen Sie die Ausführung nuget help für den gewünschten Befehl aus.

Informationen zum Verwenden grundlegender Befehle mit der nuget.exe CLI finden Sie unter Installieren und Verwenden von Paketen mithilfe der nuget.exe CLI.

Installieren von nuget.exe

Installieren Sie immer die neueste Version des Tools, das Ihre Konfiguration unterstützt.

Wenn das nuget.exe CLI-Tool bereits installiert ist, können Sie das Tool mithilfe des Befehls nuget update -selfauf die neueste Version aktualisieren.

  1. Download nuget.exe:

  2. Wenn Sie dazu aufgefordert werden, speichern Sie die Datei in einem Ordner Ihrer Wahl. Die nuget.exe Datei wird direkt heruntergeladen. Die heruntergeladene Datei ist kein Installationsprogramm, daher muss die Datei nicht direkt über den Browser ausgeführt werden.

  3. Um das CLI-Tool aus einem beliebigen Ordner zu verwenden, fügen Sie den Ordner hinzu, der die nuget.exe Datei enthält, zu Ihrer PATH Umgebungsvariable.

Tipp

Informationen zum Verfügbarmachen der NuGet CLI in der Paket-Manager-Konsole in Visual Studio finden Sie unter Using the nuget.exe CLI in the console.

Verfügbarkeit

Ausführliche Informationen finden Sie unter Featureverfügbarkeit .

  • Alle Befehle sind auf Windows verfügbar.
  • Alle Befehle funktionieren mit nuget.exe, die auf Mono ausgeführt werden, es sei denn, für pack, restoreund update.
  • Die packBefehle , restore, , deleteund pushlocalsBefehle sind auch auf Mac und Linux über die dotnet CLI verfügbar.

Befehle und Anwendbarkeit

Verfügbare Befehle und Anwendbarkeit auf Paketerstellung, Paketverbrauch und/oder Veröffentlichung eines Pakets auf einem Host:

Allgemeine Befehle Anwendbare Rollen NuGet-Version Beschreibung
packen Kreation 2.7+ Erstellt ein NuGet-Paket aus einer .nuspec oder einer Projektdatei. Wenn sie auf Mono ausgeführt wird, wird das Erstellen eines Pakets aus einer Projektdatei nicht unterstützt.
push Publishing All Veröffentlicht ein Paket in einer Paketquelle.
config All All Dient zum Abrufen oder Festlegen von NuGet-Konfigurationswerten.
hilfe oder ? All All Zeigt Hilfeinformationen oder Hilfe für einen Befehl an.
Einheimischen Verbrauch 3.3+ Listet Speicherorte der globalen Pakete, des HTTP-Caches und der temporären Ordner auf und löscht den Inhalt dieser Ordner.
restore Verbrauch 2.7+ Stellt alle Pakete wieder her, auf die im Paketverwaltungsformat verwiesen wird. Beim Ausführen auf Mono wird das Wiederherstellen von Paketen mit dem PackageReference-Format nicht unterstützt.
setapikey Veröffentlichung, Verbrauch All Speichert einen API-Schlüssel für eine bestimmte Paketquelle, wenn für diese Paketquelle ein Schlüssel für den Zugriff erforderlich ist.
Spec Kreation All Generiert eine .nuspec-Datei mit Token, wenn die Datei aus einem Visual Studio Projekt generiert wird.
Sekundäre Befehle Anwendbare Rollen NuGet-Version Beschreibung
hinzufügen Publishing 3.3+ Fügt ein Paket zu einer Nicht-HTTP-Paketquelle mit hierarchischem Layout hinzu. Verwenden Sie für HTTP-Quellen Push.
delete Publishing All Entfernt oder hebt die Liste eines Pakets aus einer Paketquelle auf.
init Kreation 3.3+ Fügt Pakete aus einem Ordner zu einer Paketquelle mithilfe des hierarchischen Layouts hinzu.
installieren Verbrauch All Installiert ein Paket im aktuellen Projekt, ändert jedoch keine Projekte oder Referenzdateien.
list Konsum, vielleicht Veröffentlichung All Zeigt Pakete aus einer bestimmten Quelle an.
Spiegel Publishing Veraltet in 3.2+ Spiegelt ein Paket und seine Abhängigkeiten von einer Quelle in ein Ziel-Repository.
suchen Verbrauch 5.8+ Durchsucht eine bestimmte Quelle mithilfe der bereitgestellten Abfragezeichenfolge.
Quellen Verbrauch, Veröffentlichung All Verwaltet Paketquellen in Konfigurationsdateien.
Aktualisierung Verbrauch All Aktualisiert die Pakete eines Projekts auf die neuesten verfügbaren Versionen. Wird nicht unterstützt, wenn sie auf Mono ausgeführt wird.

Verschiedene Befehle verwenden verschiedene Umgebungsvariablen.

NuGet CLI-Befehle nach anwendbaren Rollen:

Rolle Befehle
Verbrauch config, help, , listinstall, locals, restore, search, , , setapikey, , sourcesupdate
Kreation config, , helpinit, , packspec
Publishing add, , configdelete, help, list, push, , setapikeysources

Entwickler, die sich nur mit dem Verbrauch von Paketen befassen, müssen beispielsweise nur verstehen, dass eine Teilmenge von NuGet-Befehlen vorhanden ist.

Hinweis

Bei Befehlsoptionsnamen wird die Groß-/Kleinschreibung nicht beachtet. Veraltete Optionen sind in diesem Verweis nicht enthalten, z NoPrompt . B. (ersetzt durch NonInteractive) und Verbose (ersetzt durch Verbosity).

Localization

NuGet.exeStatus, Warnungen und Fehlermeldungen werden in dieselben Gebietsschemas wie Visual Studio übersetzt. NuGet.exe als einzelne Exe-Datei ausgeliefert und aufgrund von Größenüberlegungen werden nur die am häufigsten angezeigten Nachrichten in allen Sprachen übersetzt.

  • Last updated on