Referencia de CLI de NuGetNuGet CLI reference

La interfaz de línea de comandos (CLI de NuGet), nuget.exe, proporciona el alcance total de las funcionalidades de NuGet para instalar, crear, publicar y administrar los paquetes sin realizar cambios en los archivos de proyecto.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.

Para utilizar cualquier comando, abra una ventana de comandos o el shell de bash y ejecute nuget seguido por el comando y las opciones adecuadas, como nuget help pack (para ver la Ayuda en el comando 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).

Esta documentación refleja la versión más reciente de la CLI de NuGet.This documentation reflects the latest version of the NuGet CLI. Para obtener información exacta para cualquier versión concreta que esté usando, ejecute nuget help para el comando deseado.For exact details for any given version that you're using, run nuget help for the desired command.

Instalación de nuget.exeInstalling nuget.exe

WindowsWindows

  1. Visite nuget.org/downloads y seleccione NuGet 3.3 o posterior (2.8.6 no es compatible con Mono).Visit nuget.org/downloads and select NuGet 3.3 or higher (2.8.6 is not compatible with Mono). Siempre se recomienda la última versión, y 4.1.0+ es la versión necesaria para publicar paquetes en nuget.org.The latest version is always recommended, and 4.1.0+ is required to publish packages to nuget.org.
  2. Cada descarga es el archivo nuget.exe directamente.Each download is the nuget.exe file directly. Indique al explorador que guarde el archivo en una carpeta de su elección.Instruct your browser to save the file to a folder of your choice. El archivo no es un instalador; no verá nada si lo ejecuta directamente desde el explorador.The file is not an installer; you won't see anything if you run it directly from the browser.
  3. Agregue la carpeta donde colocó nuget.exe a la variable de entorno de RUTA DE ACCESO para usar la herramienta CLI desde cualquier lugar.Add the folder where you placed nuget.exe to your PATH environment variable to use the CLI tool from anywhere.

macOS y LinuxmacOS/Linux

Los comportamientos pueden variar ligeramente según la distribución del sistema operativo.Behaviors may vary slightly by OS distribution.

  1. Instale Mono 4.4.2 o versiones posteriores.Install Mono 4.4.2 or later.

  2. Ejecute los comandos siguientes en un símbolo del sistema del shell: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. Cree un alias mediante la adición del script siguiente al archivo apropiado del sistema operativo (normalmente ~/.bash_aliases o ~/.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. Recargue el shell.Reload the shell. Para probar la instalación, escriba nuget sin parámetros.Test the installation by entering nuget with no parameters. Debe aparecer la Ayuda de la CLI de NuGet.NuGet CLI help should display.

Sugerencia

Para que la CLI de NuGet disponible dentro de la consola de administrador de paquetes en Visual Studio, consulte mediante la CLI de nuget.exe en la consola de.To make the NuGet CLI available within the Package Manager Console in Visual Studio, see Using the nuget.exe CLI in the console.

DisponibilidadAvailability

Consulte disponibilidad de características para ver los detalles exactos.See feature availability for exact details.

  • Todos los comandos están disponibles en Windows.All commands are available on Windows.
  • Todos los comandos que funcionan con nuget.exe ejecutándose en Mono, excepto cuando se indique para pack, restore, y update.All commands work with nuget.exe running on Mono except where indicated for pack, restore, and update.
  • El pack, restore, delete, locals, y push comandos también están disponibles en Mac y Linux mediante la CLI de dotnet.The pack, restore, delete, locals, and push commands are also available on Mac and Linux through the dotnet CLI.

Comandos y aplicabilidadCommands and applicability

Los comandos disponibles y aplicabilidad a creación de paquetes, consumo de paquetes o publicar un paquete a un host:Available commands and applicability to package creation, package consumption, and/or publishing a package to a host:

Comandos comunesCommon Commands Roles aplicablesApplicable Roles Versión de NuGetNuGet Version DescripciónDescription
packpack Creación deCreation 2.7+2.7+ Crea un paquete de NuGet desde una .nuspec o archivo de proyecto.Creates a NuGet package from a .nuspec or project file. Cuando se ejecuta en Mono, no se admite la creación de un paquete desde un archivo de proyecto.When running on Mono, creating a package from a project file is not supported.
pushpush PublicaciónPublishing TodasAll Publica un paquete en un origen del paquete.Publishes a package to a package source.
configconfig TodasAll TodasAll Obtiene o establece los valores de configuración de NuGet.Gets or sets NuGet configuration values.
help or ?help or ? TodasAll TodasAll Muestra la información o ayuda para un comando de ayuda.Displays help information or help for a command.
localslocals ConsumoConsumption 3.3+3.3+ Se enumeran las ubicaciones de la global-packages, http-cache, y temp carpetas y borra el contenido de esas carpetas.Lists locations of the global-packages, http-cache, and temp folders and clears the contents of those folders.
restorerestore ConsumoConsumption 2.7+2.7+ Restaura todos los paquetes que se hace referencia el formato de paquete de administración en uso.Restores all packages referenced by the package management format in use. Cuando se ejecuta en Mono, no se admite la restauración de paquetes con el formato PackageReference.When running on Mono, restoring packages using the PackageReference format is not supported.
setapikeysetapikey Publicación de consumoPublishing, Consumption TodasAll Guarda una clave de API para un origen de paquete determinado cuando ese origen del paquete requiere una clave para el acceso.Saves an API key for a given package source when that package source requires a key for access.
specspec Creación deCreation TodasAll Genera un .nuspec de archivos, mediante los tokens si generar el archivo de un proyecto de Visual Studio.Generates a .nuspec file, using tokens if generating the file from a Visual Studio project.
Comandos secundariosSecondary Commands Roles aplicablesApplicable Roles Versión de NuGetNuGet Version DescripciónDescription
addadd PublicaciónPublishing 3.3+3.3+ Agrega un paquete a un origen de paquete que no sea HTTP con formato jerárquico.Adds a package to a non-HTTP package source using hierarchical layout. Para los orígenes HTTP, utilice inserción.For HTTP sources, use push.
deletedelete PublicaciónPublishing TodasAll Elimina o quita un paquete desde un origen del paquete de la lista.Removes or unlists a package from a package source.
initinit Creación deCreation 3.3+3.3+ Agrega paquetes desde una carpeta a un origen de paquete con formato jerárquico.Adds packages from a folder to a package source using hierarchical layout.
installinstall ConsumoConsumption TodasAll Instala un paquete en el actual del proyecto, pero no modifica los proyectos o hacen referencia a archivos.Installs a package into the current project but does not modify projects or reference files.
listlist Consumo, quizás de publicaciónConsumption, perhaps Publishing TodasAll Muestra los paquetes desde un origen determinado.Displays packages from a given source.
mirrormirror PublicaciónPublishing En desuso en 3.2 y versiones posterioresDeprecated in 3.2+ Refleja un paquete y sus dependencias de un origen a un repositorio de destino.Mirrors a package and its dependencies from a source to a target repository.
sourcessources Consumo, publicarConsumption, Publishing TodasAll Administra los orígenes de paquetes en archivos de configuración.Manages package sources in configuration files.
updateupdate ConsumoConsumption TodasAll Actualiza los paquetes de un proyecto a las últimas versiones disponibles.Updates a project's packages to the latest available versions. No se admite cuando se ejecuta en Mono.Not supported when running on Mono.

Distintos comandos hacer uso de varios variables de entorno.Different commands make use of various Environment variables.

Comandos de CLI de NuGet por roles aplicables:NuGet CLI commands by applicable roles:

RolRole ComandosCommands
ConsumoConsumption config, help, install, list, locals, restore, setapikey, sources, updateconfig, help, install, list, locals, restore, setapikey, sources, update
Creación deCreation config, help, init, pack, specconfig, help, init, pack, spec
PublicaciónPublishing add, config, delete, help, list, push, setapikey, sourcesadd, config, delete, help, list, push, setapikey, sources

Los desarrolladores que se trate únicamente con el consumo de paquetes, por ejemplo, sólo necesitan comprender ese subconjunto de comandos de NuGet.Developers concerned only with consuming packages, for example, need only understand that subset of NuGet commands.

Nota

Los nombres de opción de comando distinguen mayúsculas de minúsculas.Command option names are case-insensitive. No se incluyen opciones que están en desuso en esta referencia, como NoPrompt (reemplazado por NonInteractive) y Verbose (reemplazado por Verbosity).Options that are deprecated are not included in this reference, such as NoPrompt (replaced by NonInteractive) and Verbose (replaced by Verbosity).