Installations Befehl (nuget-CLI)install command (NuGet CLI)

Gilt für:unterstützte Versionen von Paket Verbrauch: alleApplies to: package consumption • Supported versions: all

Lädt ein Paket herunter und installiert es in ein Projekt, wobei die angegebenen Paketquellen standardmäßig auf den aktuellen Ordner zugreifen.Downloads and installs a package into a project, defaulting to the current folder, using specified package sources.

Tipp

Wenn Sie ein Paket direkt außerhalb des Kontexts eines Projekts herunterladen möchten, besuchen Sie die Seite des Pakets auf nuget.org , und wählen Sie den Download Link aus.To download a package directly outside the context of a project, visit the package's page on nuget.org and select the Download link.

Wenn keine Quellen angegeben sind, werden die in der globalen Konfigurationsdatei %appdata%\NuGet\NuGet.Config (Windows) oder ~/.nuget/NuGet/NuGet.Config (Mac/Linux) aufgeführten Quellen verwendet.If no sources are specified, those listed in the global configuration file, %appdata%\NuGet\NuGet.Config (Windows) or ~/.nuget/NuGet/NuGet.Config (Mac/Linux), are used. Weitere Informationen finden Sie unter Allgemeine nuget-Konfigurationen .See Common NuGet configurations for additional details.

Wenn keine bestimmten Pakete angegeben werden, werden install alle Pakete installiert, die in der Datei des Projekts aufgelistet sind packages.config . Dies ist vergleichbar mit restore .If no specific packages are specified, install installs all packages listed in the project's packages.config file, making it similar to restore.

Mit dem install Befehl wird eine Projektdatei oder nicht geändert packages.config . auf diese Weise ähnelt Sie in der Weise restore , dass nur Pakete auf dem Datenträger hinzugefügt werden, die Abhängigkeiten eines Projekts jedoch nicht geändert werden.The install command does not modify a project file or packages.config; in this way it's similar to restore in that it only adds packages to disk but does not change a project's dependencies.

Fügen Sie zum Hinzufügen einer Abhängigkeit entweder über die Benutzeroberfläche oder die Konsole des Paket-Managers in Visual Studio ein Paket hinzu, oder ändern Sie, packages.config und führen Sie dann entweder install oder aus restore .To add a dependency, either add a package through the Package Manager UI or Console in Visual Studio, or modify packages.config and then run either install or restore.

VerwendungUsage

nuget install <packageID | configFilePath> [options]

<packageID>dabei benennt das zu installierenden Paket (mit der aktuellen Version) oder <configFilePath> identifiziert die Datei, in der packages.config die zu installierenden Pakete aufgelistet sind.where <packageID> names the package to install (using the latest version), or <configFilePath> identifies the packages.config file that lists the packages to install. Sie können mit der Option eine bestimmte Version angeben -Version .You can indicate a specific version with the -Version option.

OptionenOptions

  • -ConfigFile

    Die anzuwendende nuget-Konfigurationsdatei.The NuGet configuration file to apply. Wenn nichts angegeben ist, %AppData%\NuGet\NuGet.Config wird (Windows) ~/.nuget/NuGet/NuGet.Config oder ~/.config/NuGet/NuGet.Config (Mac/Linux) verwendet.If not specified, %AppData%\NuGet\NuGet.Config (Windows), or ~/.nuget/NuGet/NuGet.Config or ~/.config/NuGet/NuGet.Config (Mac/Linux) is used.

  • -DependencyVersion

    (4.4 und höher) Die Version der zu verwendenden Abhängigkeits Pakete. Dies kann eine der folgenden sein:(4.4+) The version of the dependency packages to use, which can be one of the following:

    • Niedrigste (Standard): die niedrigste VersionLowest (default): the lowest version
    • Highestpatch: die Version mit dem niedrigsten, niedrigsten, niedrigsten, größten PatchHighestPatch: the version with the lowest major, lowest minor, highest patch
    • Highestminor: die Version mit dem niedrigsten Haupt-, höchst-und HöchstwertHighestMinor: the version with the lowest major, highest minor, highest patch
    • HöchsteVersion: die höchste VersionHighest: the highest version
    • Ignore: Es werden keine Abhängigkeits Pakete verwendet.Ignore: No dependency packages will be used

  • -DirectDownload

    Direkt herunterladen, ohne Caches mit Metadaten oder Binärdateien aufzufüllen.Download directly without populating any caches with metadata or binaries.

  • -DisableParallelProcessing

    Deaktiviert das parallele Installieren mehrerer Pakete.Disables installing multiple packages in parallel.

  • -x|-ExcludeVersion

    Installiert das Paket in einem Ordner mit dem Namen, der nur den Paketnamen und nicht die Versionsnummer hat.Installs the package to a folder named with only the package name and not the version number.

  • -FallbackSource

    (3.2 +) Eine Liste von Paketquellen, die als Fallbacks verwendet werden sollen, falls das Paket nicht in der primären oder der Standard Quelle gefunden wurde.(3.2+) A list of package sources to use as fallbacks in case the package isn't found in the primary or default source.

  • -ForceEnglishOutput

    (3.5 und höher) Erzwingt das Ausführen von nuget.exe mit einer invarianten, englischen Kultur.(3.5+) Forces nuget.exe to run using an invariant, English-based culture.

  • -Framework

    (4.4 und höher) Ziel Framework, das zum Auswählen von Abhängigkeiten verwendet wird.(4.4+) Target framework used for selecting dependencies. Der Standardwert ist "Any", wenn kein Wert angegeben ist.Defaults to 'Any' if not specified.

  • -?|-help

    Zeigt Hilfe Informationen für den Befehl an.Displays help information for the command.

  • -NoCache

    Verhindert, dass nuget zwischengespeicherte Pakete verwendet.Prevents NuGet from using cached packages. Weitere Informationen finden Sie unter Verwalten der globalen Pakete und Cache Ordner.See Managing the global packages and cache folders.

  • -NonInteractive

    Unterdrückt Eingabe Aufforderungen für Benutzereingaben oder Bestätigungen.Suppresses prompts for user input or confirmations.

  • -OutputDirectory

    Gibt den Ordner an, in dem Pakete installiert werden.Specifies the folder in which packages are installed. Wenn kein Ordner angegeben wird, wird der aktuelle Ordner verwendet.If no folder is specified, the current folder is used.

  • -PackageSaveMode

    Gibt die Dateitypen an, die nach der Paketinstallation gespeichert werden sollen: einer von nuspec , nupkg oder nuspec;nupkg .Specifies the types of files to save after package installation: one of nuspec, nupkg, or nuspec;nupkg.

  • -PreRelease

    Ermöglicht die Installation von vorab Versionen.Allows prerelease packages to be installed. Dieses Flag ist beim Wiederherstellen von Paketen mit nicht erforderlich packages.config .This flag is not required when restoring packages with packages.config.

  • -RequireConsent

    Überprüft, ob das Wiederherstellen von Paketen aktiviert ist, bevor die Pakete heruntergeladen und installiert werden.Verifies that restoring packages is enabled before downloading and installing the packages. Weitere Informationen finden Sie unter Paket Wiederherstellung.For details, see Package Restore.

  • -SolutionDirectory

    Gibt den Stamm Ordner der Projekt Mappe an, für die Pakete wieder hergestellt werden sollen.Specifies root folder of the solution for which to restore packages.

  • -Source

    Gibt die Liste der zu verwendenden Paketquellen (als URLs) an.Specifies the list of package sources (as URLs) to use. Wenn der Befehl nicht angegeben wird, verwendet der Befehl die in den Konfigurationsdateien bereitgestellten Quellen, siehe Allgemeine nuget-Konfigurationen.If omitted, the command uses the sources provided in configuration files, see Common NuGet configurations.

  • -Verbosity [normal|quiet|detailed]

    Gibt den Umfang der in der Ausgabe angezeigten Details an: normal (Standard), quiet oder detailed .Specifies the amount of detail displayed in the output: normal (the default), quiet, or detailed.

  • -Version

    Gibt die Version des zu installierenden Pakets an.Specifies the version of the package to install.

Siehe auch UmgebungsvariablenAlso see Environment variables

BeispieleExamples

nuget install elmah

nuget install packages.config

nuget install ninject -OutputDirectory c:\proj