Installationsbefehl (NuGet CLI)

Gilt für: Paketverbrauch • Unterstützte Versionen: alle

Lädt ein Paket herunter und installiert es in einem Projekt, standardmäßig im aktuellen Ordner, unter Verwendung der angegebenen Paketquellen.

Tipp

Um ein Paket direkt außerhalb des Projektkontexts herunterzuladen, besuchen Sie die Seite des Pakets auf nuget.org und wählen Sie den Link Download.

Wenn keine Quellen angegeben werden, werden die in der globalen Konfigurationsdatei %appdata%\NuGet\NuGet.Config (Windows) oder ~/.nuget/NuGet/NuGet.Config (Mac/Linux) aufgeführten Quellen verwendet. Siehe Allgemeine NuGet-Konfigurationen für weitere Details.

Wenn keine spezifischen Pakete angegeben sind, installiert install alle Pakete, die in der packages.config-Datei des Projekts aufgeführt sind, und ist damit ähnlich wie restore.

Der install-Befehl nimmt keine Änderungen an einer Projektdatei oder packages.config vor. Damit ähnelt er restore darin, dass Pakete nur zum Datenträger hinzugefügt, aber die Abhängigkeiten eines Projekts nicht geändert werden.

Um eine Abhängigkeit hinzuzufügen, fügen Sie ein Paket entweder über den Paket-Manager oder die Konsole in Visual Studio hinzu. Als dritte Möglichkeit können Sie packages.config ändern und anschließend install oder restore ausführen.

Verbrauch

nuget install <packageID | configFilePath> [options]

wobei <packageID> den Namen des zu installierenden Pakets angibt (unter Verwendung der neuesten Version) oder <configFilePath> die Datei packages.config identifiziert, in der die zu installierenden Pakete aufgelistet sind. Sie können eine bestimmte Version mit der -Version-Option angeben.

Optionen

• -ConfigFile

  Die NuGet-Konfigurationsdatei. Wenn nicht angegeben, %AppData%\NuGet\NuGet.Config (Windows) oder ~/.nuget/NuGet/NuGet.Config~/.config/NuGet/NuGet.Config (Mac/Linux) wird verwendet.

• -DependencyVersion

  (4.4+) Die Version der zu verwendenden Abhängigkeitspakete, die eine der folgenden sein kann:
  

  • Lowest (Standard): die niedrigste Version
  • HighestPatch: die Version mit dem niedrigsten Maximum, dem niedrigsten Minimum und dem höchsten Patch
  • HighestPatch: die Version mit dem niedrigsten Maximum, dem höchsten Minimum und dem höchsten Patch
  • Höchste Version: die höchste Version
  • Ignorieren: Es werden keine Abhängigkeitspakete verwendet

• -DirectDownload

  Direktes Herunterladen, ohne Metadaten oder Binärdateien in den Cache zu laden.

• -DisableParallelProcessing

  Deaktiviert die parallele Installation mehrerer Pakete.

• -x|-ExcludeVersion

  Installiert das Paket in einen Ordner, der nur mit dem Paketnamen und nicht mit der Versionsnummer benannt ist.

• -FallbackSource

  (3.2+) Eine Liste von Paketquellen, die als Fallback verwendet werden, falls das Paket nicht in der primären oder Standardquelle gefunden wird.

• -ForceEnglishOutput

  (3.5+) Erzwingt die Ausführung der Anwendung mithilfe einer invarianten Kultur, die auf Englisch basiert.

• -Framework

  (4,4+) Zielframework, der für die Auswahl der Abhängigkeiten verwendet wird. Wird auf den Standardwert „Beliebig“ festgelegt, wenn kein Name angegeben wird.

• -?|-help

  Druckt Hilfeinformationen für den Befehl.

• -NoHttpCache

  Verhindert, dass NuGet über http gecachte Pakete verwendet. Siehe Verwalten von globalen Paketen und Cacheordnern.

• -NonInteractive

  Fordert nicht zu Eingaben oder Bestätigungen des Benutzers auf.

• -OutputDirectory

  Gibt den Ordner an, in dem Pakete installiert sind. Wird dieses Argument nicht angegeben, wird der aktuelle Ordner verwendet.

• -PackageSaveMode

  Gibt die Dateitypen an, die nach der Paketinstallation gespeichert werden sollen: eine der Optionen nuspec, nupkg, oder nuspec;nupkg.

• -PreRelease

  Ermöglicht die Installation von Paketen mit Vorabversionen Dieses Flag ist nicht erforderlich, wenn Pakete mit packages.config wiederhergestellt werden.

• -RequireConsent

  Überprüft, ob die Wiederherstellung von Paketen aktiviert ist, bevor die Pakete heruntergeladen und installiert werden. Weitere Informationen finden Sie unter Paketwiederherstellung.

• -SolutionDirectory

  Gibt den Stammordner der Lösung an, für die Pakete wiederhergestellt werden sollen.

• -Source

  Gibt die Liste der zu verwendenden Paketquellen (als URLs) an. Wenn sie weggelassen wird, verwendet der Befehl die in Konfigurationsdateien bereitgestellten Quellen unter "Allgemeine NuGet-Konfigurationen".

• -Verbosity [normal|quiet|detailed]

  Gibt an, wie viele Details in der Ausgabe angezeigt werden: normal (der Standard), quiet oder detailed.

• -Version

  Gibt die Version des zu installierenden Pakets an.

Weitere Informationen finden Sie unter Umgebungsvariablen

Beispiele

nuget install elmah

nuget install packages.config

nuget install ninject -OutputDirectory c:\proj