Verweis auf NuGet-CLI

  • Artikel

Die NuGet-Befehlszeilenschnittstelle (Command-Line Interface, CLI), nuget.exe, bietet die gesamte Bandbreite an NuGet-Funktionen zum Installieren, Erstellen, Veröffentlichen und Verwalten von Paketen, ohne dabei Änderungen an Projektdateien vorzunehmen.

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

Diese Dokumentation bezieht sich auf die aktuelle Version der NuGet-CLI. Wenn Sie genauere Informationen für die von Ihnen verwendete Version benötigen, führen Sie nuget help für den gewünschten Befehl aus.

Informationen zur Verwendung grundlegender Befehle der nuget.exe-CLI finden Sie unter Installieren und Verwenden von Paketen mit der nuget.exe-CLI.

Installieren von nuget.exe

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

  • Sie können die neueste empfohlene Version unter https://dist.nuget.org/win-x86-commandline/latest/nuget.exe herunterladen.
  • Wenn Sie das nuget.exe CLI-Tool bereits installiert haben, können Sie es mit dem Befehl nuget update -self auf die neueste Version aktualisieren.
  • Für die Kompatibilität mit älteren Continuous Integration-Systemen wird aktuell über die vorherige URL, https://nuget.org/nuget.exe, die veraltete Version 2.8.6 des CLI-Tools zur Verfügung gestellt.

  1. Besuchen Sie nuget.org/downloads und laden Sie NuGet-Version 3.3 oder höher herunter.

    • Version 5.0 und höher erfordert .NET Framework Version 4.7.2 oder höher.
    • Version 4.1.0 und höher ist erforderlich, um Pakete auf nuget.org zu veröffentlichen.
    • Version 2.8.6 ist nicht mit Mono kompatibel.

  2. Jeder Download ist direkt die Datei nuget.exe. Weisen Sie Ihren Browser an, die Datei in einem Ordner Ihrer Wahl zu speichern. Der Download ist kein Installationsprogramm, d. h. Sie sehen nichts, wenn Sie die Datei direkt über den Browser ausführen.

  3. Um das CLI-Tool von einem beliebigen Ort aus zu verwenden, fügen Sie den Speicherort (Ordner) der nuget.exe-Datei zu Ihrer Umgebungsvariablen PATH hinzu.

Tipp

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

Verfügbarkeit

Ausführliche Informationen finden Sie unter Feature-Verfügbarkeit .

  • Alle Befehle sind in Windows verfügbar.
  • Sämtliche Befehle funktionieren, wenn nuget.exe auf Mono ausgeführt wird, außer gegebenenfalls pack, restore und update.
  • Die Befehle pack, restore, delete, locals und push 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 Anwendungsrollen NuGet-Version Beschreibung
Paket Erstellung 2.7+ Erstellt ein NuGet-Paket aus einer .nuspec oder einer Projektdatei. In Mono wird das Erstellen von Paketen aus einer Projektdatei nicht unterstützt.
push Veröffentlichung All Veröffentlicht ein Paket an einer Paketquelle.
config All Alle Ruft einen Konfigurationswert ab oder legt diesen fest.
help or ? All Alle Zeigt Hilfeinformationen oder Hilfe für einen Befehl an.
locals Verbrauch 3.3+ Listet Speicherorte der Ordner global-packages, http-cache und temp auf und löscht den Inhalt dieser Ordner.
restore Verbrauch 2.7+ Stellt alle Pakete wieder her, auf die im Paketverwaltungsformat verwiesen wird. In 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 den Zugriff auf diese Paketquelle ein Schlüssel erforderlich ist.
spec Erstellung All Generiert eine .nuspec-Datei mit Hilfr von Token, wenn die Datei aus einem Visual Studio-Projekt generiert wird.
Sekundäre Befehle Anwendungsrollen NuGet-Version Beschreibung
add Veröffentlichung 3.3+ Fügt mit hierarchischem Layout ein Paket zu einer Nicht-HTTP-Paketquelle hinzu. Verwenden Sie für HTTP-Quellen Push.
Löschen Veröffentlichung All Entfernt ein Paket aus einer Paketquelle oder löscht es aus der Liste.
init Erstellung 3.3+ Fügt mit hierarchischem Layout Pakete aus einem Ordner zu einer Paketquelle hinzu.
Installieren Verbrauch All Installiert ein Paket im aktuellen Projekt, ändert jedoch keine Projekte oder Referenzdateien.
list Verbrauch, vielleicht Veröffentlichung All Zeigt Pakete aus einer bestimmten Quelle an.
mirror Veröffentlichung Veraltet in 3.2+ Spiegelt ein Paket und dessen Abhängigkeiten aus einer Quelle in ein Ziel-Repository.
search Verbrauch 5.8+ Durchsucht eine bestimmte Quelle mithilfe der bereitgestellten Abfragezeichenfolge.
sources Verbrauch, Veröffentlichung All Verwaltet Paketquellen in Konfigurationsdateien.
Aktualisierung Verbrauch All Aktualisiert alle Pakete in einem Projekt auf die neuesten verfügbaren Versionen. Wird in Mono nicht unterstützt.

Verschiedene Befehle nutzen verschiedene Umgebungsvariablen.

NuGet-CLI-Befehle nach Anwendungsrollen:

Rolle Befehle
Verbrauch config, help, install, list, locals, restore, search, setapikey, sources, update
Erstellung config, help, init, pack, spec
Veröffentlichung add, config, delete, help, list, push, setapikey, sources

Entwickler, die sich nur mit dem Verbrauch von Paketen befassen, müssen zum Beispiel nur diese Teilmenge der NuGet-Befehle verstehen.

Hinweis

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

Lokalisierung

Status, Warnungen und Fehlermeldungen von NuGet.exe werden in die gleichen Gebietsschemata wie Visual Studio übersetzt. NuGet.exe wird als eine einzige Exe-Datei ausgeliefert, und aufgrund der Größe werden nur die am häufigsten vorkommenden Meldungen in alle Sprachen übersetzt.