Referencia de NuGet CLINuGet CLI reference

La interfaz de línea de comandos de NuGet (CLI), nuget.exe, proporciona el alcance total de la funcionalidad de NuGet para instalar, crear, publicar y administrar los paquetes sin realizar ningún cambio 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 luego ejecutar nuget seguido por el comando y opciones adecuadas, como nuget help pack (para ver la ayuda sobre 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 NuGet CLI.This documentation reflects the latest version of the NuGet CLI. Para obtener detalles exactos 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.

Instalar 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 disponer de la CLI de NuGet dentro de la consola de administrador de paquetes en Visual Studio, vea mediante la CLI 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

Vea disponibilidad de las funciones para obtener 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 funcionan con nuget.exe quedando 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 a través de 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

Comandos disponibles y aplicabilidad a la creación del paquete, el consumo de paquete 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ónCreation 2.7+2.7+ Crea un paquete de NuGet desde un .nuspec o un 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 a un origen de 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 Ayuda información o ayuda para un comando.Displays help information or help for a command.
localslocals ConsumoConsumption 3.3+3.3+ Enumera las ubicaciones de la global paquetes, caché http, 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 al que hace referencia el formato de la administración de paquetes 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 determinado paquete de origen cuando ese origen del paquete requiere una clave de acceso.Saves an API key for a given package source when that package source requires a key for access.
specspec CreaciónCreation TodasAll Genera un .nuspec archivo, utilizando tokens si genera el archivo desde 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 no 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 Quita o unlists un paquete desde un origen del paquete.Removes or unlists a package from a package source.
initinit CreaciónCreation 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 proyecto pero no modificar proyectos o hacen referencia a archivos.Installs a package into the current project but does not modify projects or reference files.
listlist Consumo, es posible publicarConsumption, perhaps Publishing TodasAll Muestra los paquetes de un origen determinado.Displays packages from a given source.
mirrormirror PublicaciónPublishing En desuso en 3.2 +Deprecated in 3.2+ Refleja un paquete y sus dependencias de un origen en 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 del proyecto para 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.

Asegúrese de comandos diferentes que el uso de varios variables de entorno.Different commands make use of various Environment variables.

Comandos de CLI de NuGet 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ónCreation 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 programadores preocupados solo con el consumo de paquetes, por ejemplo, solo 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).