Verweis auf NuGet-CLI

Die NuGet Befehlszeilenschnittstelle (COMMAND Line Interface, CLI) nuget.exebietet den vollständigen Umfang der NuGet Funktionen 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 vom Befehl und den entsprechenden Optionen aus, z nuget help pack . B. (um hilfe zum Befehl pack anzuzeigen).

Diese Dokumentation gibt die neueste Version der NuGet CLI wieder. Führen Sie für den gewünschten Befehl aus, um genaue Details zu einer bestimmten Version zu nuget help erhalten, die Sie verwenden.

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

Windows

Hinweis

Für die Ausführung von NuGet.exe 5.0 und höher ist .NET Framework 4.7.2 erforderlich.

  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). Die neueste Version wird immer empfohlen, und 4.1.0+ ist erforderlich, um Pakete in „nuget.org“ zu veröffentlichen.
  2. Jeder Download ist direkt die Datei nuget.exe. Weisen Sie Ihren Browser an, die Datei in einem Ordner Ihrer Wahl zu speichern. Die Datei ist kein Installationsprogramm; es wird nichts angezeigt, wenn Sie es direkt über den Browser ausführen.
  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.

macOS/Linux

Das Verhalten kann je nach Betriebssystemdistribution leicht variieren.

  1. Installieren Sie Mono 4.4.2 oder höher.

  2. Führen Sie an einer Shelleingabeaufforderung folgenden Befehl aus:

    # 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 as alias for nuget
    alias nuget="mono /usr/local/bin/nuget.exe"
    
  4. Laden Sie die Shell neu. Testen Sie die Installation, indem Sie nuget ohne Parameter eingeben. Die NuGet-CLI-Hilfe sollte angezeigt werden.

Tipp

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

Verfügbarkeit

Genaue Details finden Sie unter Featureverfügbarkeit .

  • Alle Befehle sind auf Windows verfügbar.
  • Alle Befehle funktionieren mit nuget.exe, die unter Mono ausgeführt werden, außer wenn für pack, restoreund updateangegeben.
  • Die packBefehle , restore, delete, localsund push sind auch unter Mac und Linux über die dotnet CLI verfügbar.

Befehle und Anwendbarkeit

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

Allgemeine Befehle Anwendbare Rollen NuGet-Version Beschreibung
pack Erstellung 2.7 und höher Erstellt ein NuGet-Paket aus einer - oder -.nuspecProjektdatei. Beim Ausführen unter Mono wird das Erstellen eines Pakets aus einer Projektdatei nicht unterstützt.
push Veröffentlichung Alle Veröffentlicht ein Paket in einer Paketquelle.
config All Alle Ruft NuGet Konfigurationswerte ab oder legt diese fest.
help or ? Alle All Zeigt Hilfeinformationen oder Hilfe für einen Befehl an.
locals Nutzung 3.3+ Listet Die Speicherorte der Ordner global-packages, http-cache und temp auf und löscht den Inhalt dieser Ordner.
restore Nutzung 2.7 und höher Stellt alle Pakete wieder her, auf die vom verwendeten Paketverwaltungsformat verwiesen wird. Bei Ausführung unter Mono wird das Wiederherstellen von Paketen mit dem PackageReference-Format nicht unterstützt.
setapikey Veröffentlichen, Verbrauch Alle Speichert einen API-Schlüssel für eine bestimmte Paketquelle, wenn diese Paketquelle einen Schlüssel für den Zugriff benötigt.
spec Erstellung Alle Generiert eine .nuspec Datei unter Verwendung von Token, wenn die Datei aus einem Visual Studio Projekt generiert wird.
Sekundäre Befehle Anwendbare Rollen NuGet-Version Beschreibung
add Veröffentlichung 3.3+ Fügt einer Nicht-HTTP-Paketquelle mithilfe des hierarchischen Layouts ein Paket hinzu. Verwenden Sie für HTTP-Quellen Push.
delete Veröffentlichung Alle Entfernt oder hebt die Liste eines Pakets aus einer Paketquelle auf.
init Erstellung 3.3+ Fügt pakete aus einem Ordner mithilfe des hierarchischen Layouts einer Paketquelle hinzu.
install Nutzung All Installiert ein Paket im aktuellen Projekt, ändert jedoch keine Projekte oder Verweisdateien.
list Verbrauch, vielleicht Veröffentlichung All Zeigt Pakete aus einer bestimmten Quelle an.
mirror Veröffentlichung In 3.2 und mehr als veraltet Spiegelung eines Pakets und seiner Abhängigkeiten von einer Quelle in ein Ziel-Repository.
search Nutzung 5.8+ Durchsucht eine bestimmte Quelle mithilfe der bereitgestellten Abfragezeichenfolge.
sources Verbrauch, Veröffentlichung Alle Verwaltet Paketquellen in Konfigurationsdateien.
update Nutzung All Aktualisiert die Pakete eines Projekts auf die neuesten verfügbaren Versionen. Wird bei Ausführung unter Mono nicht unterstützt.

Verschiedene Befehle verwenden verschiedene Umgebungsvariablen.

NuGet CLI-Befehle nach entsprechenden Rollen:

Role Befehle
Nutzung 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 der Nutzung von Paketen befassen, müssen z. B. 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 NoPrompt . B. (ersetzt durch NonInteractive) und Verbose (ersetzt durch Verbosity).