Dokumentacja interfejsu wiersza polecenia NuGetNuGet CLI reference

NuGet interfejsu wiersza polecenia (CLI), nuget.exe, oferuje pełny zakres funkcji NuGet do zainstalowania, tworzenie, publikowanie i zarządzanie pakietami bez wprowadzania żadnych zmian w plikach projektu.The NuGet Command Line Interface (CLI), nuget.exe, provides the full extent of NuGet functionality to install, create, publish, and manage packages without making any changes to project files.

Aby użyć dowolnego polecenia, Otwórz okno polecenia lub powłokę bash, a następnie uruchom nuget następuje poleceń i odpowiednie opcje, takie jak nuget help pack (Aby wyświetlić Pomoc dotyczącą polecenia dodatkiem Service pack).To use any command, open a command window or bash shell, then run nuget followed by the command and appropriate options, such as nuget help pack (to view help on the pack command).

Ta dokumentacja zawiera najnowszą wersję interfejsu wiersza polecenia NuGet.This documentation reflects the latest version of the NuGet CLI. Aby uzyskać szczegółowymi informacjami na temat dla danej wersji, którego używasz, uruchom nuget help dla żądanego polecenia.For exact details for any given version that you're using, run nuget help for the desired command.

Instalowanie nuget.exeInstalling nuget.exe

WindowsWindows

  1. Odwiedź stronę nuget.org/downloads i wybierz polecenie NuGet 3.3 albo nowszej (2.8.6 nie jest zgodny z platformy Mono).Visit nuget.org/downloads and select NuGet 3.3 or higher (2.8.6 is not compatible with Mono). Najnowszą wersję zawsze jest zalecana i 4.1.0+ jest wymagana do publikowania pakietów nuget.org.The latest version is always recommended, and 4.1.0+ is required to publish packages to nuget.org.
  2. Każda wersja jest nuget.exe pliku bezpośrednio.Each download is the nuget.exe file directly. Poinstruuj przeglądarkę, aby zapisać plik w wybranym folderze.Instruct your browser to save the file to a folder of your choice. Plik jest nie wiadomość Instalatora; nie znajdziesz już niczego po uruchomieniu bezpośrednio z przeglądarki.The file is not an installer; you won't see anything if you run it directly from the browser.
  3. Dodaj folder, w którym została umieszczona nuget.exe do zmiennej środowiskowej PATH, aby użyć narzędzia interfejsu wiersza polecenia z dowolnego miejsca.Add the folder where you placed nuget.exe to your PATH environment variable to use the CLI tool from anywhere.

macOS/LinuxmacOS/Linux

Zachowania mogą się nieco różnić przez funkcję dystrybucji systemu operacyjnego.Behaviors may vary slightly by OS distribution.

  1. Zainstaluj Mono 4.4.2 lub nowszej.Install Mono 4.4.2 or later.

  2. Wykonaj następujące polecenie w wierszu polecenia powłoki:Execute the following command at a shell prompt:

    # 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. Tworzenie aliasu, dodając poniższy skrypt do pliku odpowiednią dla Twojego systemu operacyjnego (zazwyczaj ~/.bash_aliases lub ~/.bash_profile):Create an alias by adding the following script to the appropriate file for your OS (typically ~/.bash_aliases or ~/.bash_profile):

    # Create as alias for nuget
    alias nuget="mono /usr/local/bin/nuget.exe"
    
  4. Załaduj ponownie powłoki.Reload the shell. Przetestuj instalację, wprowadzając nuget bez parametrów.Test the installation by entering nuget with no parameters. Interfejs wiersza polecenia NuGet pomocy powinna być wyświetlana.NuGet CLI help should display.

Porada

Aby udostępnić interfejs wiersza polecenia NuGet w konsoli Menedżera pakietów w programie Visual Studio, zobacz przy użyciu nuget.exe interfejsu wiersza polecenia w konsoli.To make the NuGet CLI available within the Package Manager Console in Visual Studio, see Using the nuget.exe CLI in the console.

DostępnośćAvailability

Zobacz dostępność funkcji dla szczegółowymi informacjami na temat.See feature availability for exact details.

  • Wszystkie polecenia są dostępne w Windows.All commands are available on Windows.
  • Wszystkie polecenia pracować nuget.exe systemem platformy Mono, z wyjątkiem sytuacji, gdy należy określić pack, restore, i update.All commands work with nuget.exe running on Mono except where indicated for pack, restore, and update.
  • pack, restore, delete, locals, I push polecenia są również dostępne na komputerach Mac i Linux za pomocą interfejsu wiersza polecenia platformy dotnet.The pack, restore, delete, locals, and push commands are also available on Mac and Linux through the dotnet CLI.

Polecenia i możliwości zastosowaniaCommands and applicability

Dostępne polecenia i ma zastosowanie do tworzenia pakietów, użycie pakietu i/lub opublikować pakiet do hosta:Available commands and applicability to package creation, package consumption, and/or publishing a package to a host:

Typowe poleceniaCommon Commands Odpowiednich rólApplicable Roles NuGet w wersjiNuGet Version OpisDescription
pakietpack TworzenieCreation 2.7+2.7+ Tworzy pakiet NuGet z .nuspec lub pliku projektu.Creates a NuGet package from a .nuspec or project file. Podczas uruchamiania na platformy Mono, tworzenie pakietu z pliku projektu nie jest obsługiwana.When running on Mono, creating a package from a project file is not supported.
pushpush PublikowaniePublishing WszystkieAll Publikuje pakiet do źródła pakietu.Publishes a package to a package source.
configconfig WszystkieAll WszystkieAll Pobiera lub ustawia wartości konfiguracji NuGet.Gets or sets NuGet configuration values.
help or ?help or ? WszystkieAll WszystkieAll Wyświetla Pomoc informacje lub pomoc dla polecenia.Displays help information or help for a command.
localslocals UżycieConsumption 3.3+3.3+ Wyświetla lokalizacje globalnymi pakietami, pamięci podręcznej http, i temp foldery i czyści zawartość tych folderów.Lists locations of the global-packages, http-cache, and temp folders and clears the contents of those folders.
restorerestore UżycieConsumption 2.7+2.7+ Przywraca wszystkie pakiety, które odwołuje się formatu używanego pakietu zarządzania.Restores all packages referenced by the package management format in use. Podczas uruchamiania na platformy Mono, przywracanie pakietów przy użyciu formatu PackageReference nie jest obsługiwana.When running on Mono, restoring packages using the PackageReference format is not supported.
setapikeysetapikey Publikowanie i użyciaPublishing, Consumption WszystkieAll Zapisuje klucz interfejsu API dla danego pakietu źródła, podczas tego źródła pakietów wymaga klucza dostępu.Saves an API key for a given package source when that package source requires a key for access.
specspec TworzenieCreation WszystkieAll Generuje .nuspec plików, przy użyciu tokenów, jeśli generuje plik z projektu programu Visual Studio.Generates a .nuspec file, using tokens if generating the file from a Visual Studio project.
Dodatkowych poleceńSecondary Commands Odpowiednich rólApplicable Roles NuGet w wersjiNuGet Version OpisDescription
addadd PublikowaniePublishing 3.3+3.3+ Dodaje pakiet do źródła pakietu protokołu HTTP przy użyciu układzie hierarchicznym.Adds a package to a non-HTTP package source using hierarchical layout. W przypadku źródła HTTP, użyj wypychania.For HTTP sources, use push.
deletedelete PublikowaniePublishing WszystkieAll Usuwa lub unlists pakietu ze źródła pakietu.Removes or unlists a package from a package source.
initinit TworzenieCreation 3.3+3.3+ Dodaje pakiety z folderu do źródła pakietu przy użyciu układzie hierarchicznym.Adds packages from a folder to a package source using hierarchical layout.
installinstall UżycieConsumption WszystkieAll Instaluje pakiet do bieżącego projektu, ale nie modyfikować projekty lub odwoływać się do plików.Installs a package into the current project but does not modify projects or reference files.
listlist Zużycie, może być publikowaniaConsumption, perhaps Publishing WszystkieAll Wyświetla pakiety z danego źródła.Displays packages from a given source.
mirrormirror PublikowaniePublishing Przestarzałe w 3.2 +Deprecated in 3.2+ Odzwierciedla pakietu oraz jego zależności ze źródła do repozytorium docelowego.Mirrors a package and its dependencies from a source to a target repository.
sourcessources Zużycie, publikowanieConsumption, Publishing WszystkieAll Zarządza źródłami pakietów w plikach konfiguracji.Manages package sources in configuration files.
updateupdate UżycieConsumption WszystkieAll Aktualizacje pakietów projektu do najnowszej dostępnej wersji.Updates a project's packages to the latest available versions. Nieobsługiwane w przypadku uruchomienia w Mono.Not supported when running on Mono.

Różne polecenia należy używać różnych zmienne środowiskowe.Different commands make use of various Environment variables.

Polecenia interfejsu wiersza polecenia NuGet w odpowiednich ról:NuGet CLI commands by applicable roles:

RolaRole PoleceniaCommands
UżycieConsumption config, help, install, list, locals, restore, setapikey, sources, updateconfig, help, install, list, locals, restore, setapikey, sources, update
TworzenieCreation config, help, init, pack, specconfig, help, init, pack, spec
PublikowaniePublishing add, config, delete, help, list, push, setapikey, sourcesadd, config, delete, help, list, push, setapikey, sources

Deweloperów zainteresowanych tylko w przypadku używania pakietów, na przykład, należy tylko informacje o tego podzbioru polecenia NuGet.Developers concerned only with consuming packages, for example, need only understand that subset of NuGet commands.

Uwaga

Nazwy opcji polecenia jest rozróżniana wielkość liter.Command option names are case-insensitive. Opcje, które zostały zaniechane nie są uwzględnione w to odwołanie, takich jak NoPrompt (zastępuje NonInteractive) i Verbose (zastępuje Verbosity).Options that are deprecated are not included in this reference, such as NoPrompt (replaced by NonInteractive) and Verbose (replaced by Verbosity).