Comparteix a través de

Referencia de la CLI de NuGet

La interfaz de la línea de comandos (CLI) de NuGet proporciona nuget.exetoda la extensión de la funcionalidad de NuGet para instalar, crear, publicar y administrar paquetes sin realizar ningún cambio en los archivos del proyecto.

Para usar cualquier comando, abra una ventana de comandos o un shell de Bash y, a continuación, ejecute nuget seguido del comando y las opciones adecuadas, como nuget help pack (para ver ayuda en el comando pack).

Esta documentación refleja la versión más reciente de la CLI de NuGet. Para obtener detalles exactos de cualquier versión determinada que use, ejecute nuget help para el comando deseado.

Para obtener información sobre cómo usar comandos básicos con la nuget.exe CLI, consulte Instalación y uso de paquetes mediante la CLI de nuget.exe.

Instalación de nuget.exe

Instale siempre la versión más reciente de la herramienta que admita la configuración.

Si la herramienta de la nuget.exe CLI ya está instalada, puede actualizar la herramienta a la versión más reciente mediante el comando nuget update -self.

  1. Descargar nuget.exe:

  2. Cuando se le solicite, guarde el archivo en una carpeta de su elección. El archivo nuget.exe se descarga directamente. El archivo descargado no es un instalador, por lo que no es necesario ejecutar el archivo directamente desde el explorador.

  3. Para usar la herramienta cli de cualquier carpeta, agregue la carpeta que contiene el archivo nuget.exe a la PATH variable de entorno.

Sugerencia

Para que la CLI de NuGet esté disponible en la consola de Administrador de paquetes en Visual Studio, consulte Uso de la CLI de nuget.exe en la consola.

Availability

Consulte disponibilidad de características para obtener detalles exactos.

  • Todos los comandos están disponibles en Windows.
  • Todos los comandos funcionan con nuget.exe que se ejecutan en Mono, excepto donde se indica para pack, restorey update.
  • Los packcomandos , restore, delete, localsy push también están disponibles en Mac y Linux a través de la CLI de dotnet.

Comandos y aplicabilidad

Comandos disponibles y aplicabilidad a la creación de paquetes, el consumo de paquetes o la publicación de un paquete en un host:

Comandos comunes Roles aplicables Versión de NuGet Descripción
empaquetar Creación 2.7+ Crea un paquete NuGet a partir de un .nuspec archivo de proyecto o . Cuando se ejecuta en Mono, no se admite la creación de un paquete a partir de un archivo de proyecto.
push Publicación Todos Publica un paquete en un origen de paquete.
config Todos Todos Obtiene o establece valores de configuración de NuGet.
ayuda o ? Todos Todos Muestra información de ayuda o ayuda para un comando.
variables locales Consumo 3.3+ Enumera las ubicaciones de las carpetas global-packages, http-cache y temp y borra el contenido de esas carpetas.
restore Consumo 2.7+ Restaura todos los paquetes a los que hace referencia el formato de administración de paquetes en uso. Cuando se ejecuta en Mono, no se admite la restauración de paquetes mediante el formato PackageReference.
setapikey Publicación, consumo Todos Guarda una clave de API para un origen de paquete determinado cuando ese origen de paquete requiere una clave para el acceso.
especificación Creación Todos Genera un archivo /> de
Comandos secundarios Roles aplicables Versión de NuGet Descripción
agregar Publicación 3.3+ Agrega un paquete a un origen de paquete que no es HTTP mediante el diseño jerárquico. Para orígenes HTTP, use push.
delete Publicación Todos Quita o anula la lista de un paquete de un origen de paquete.
init Creación 3.3+ Agrega paquetes de una carpeta a un origen de paquete mediante el diseño jerárquico.
install Consumo Todos Instala un paquete en el proyecto actual, pero no modifica proyectos ni archivos de referencia.
list Consumo, quizás publicación Todos Muestra paquetes de un origen determinado.
reflejo Publicación En desuso en la versión 3.2+ Refleja un paquete y sus dependencias de un origen en un repositorio de destino.
buscar Consumo 5.8+ Busca en un origen determinado mediante la cadena de consulta proporcionada.
orígenes Consumo, publicación Todos Administra orígenes de paquetes en archivos de configuración.
actualización Consumo Todos Actualiza los paquetes de un proyecto a las versiones más recientes disponibles. No se admite cuando se ejecuta en Mono.

Los distintos comandos usan varias variables de entorno.

Comandos de la CLI de NuGet por roles aplicables:

Función Commands
Consumo config, help, install, list, locals, restore, search, setapikey, , sourcesupdate
Creación config, help, init, , pack, spec
Publicación add, config, delete, help, list, push, , setapikeysources

Los desarrolladores interesados solo con el consumo de paquetes, por ejemplo, solo necesitan comprender ese subconjunto de comandos NuGet.

Nota:

Los nombres de opción de comando no distinguen mayúsculas de minúsculas. Las opciones que están en desuso no se incluyen en esta referencia, como NoPrompt (reemplazada por NonInteractive) y Verbose (reemplazadas por Verbosity).

Localization

NuGet.exelos mensajes de progreso, advertencia y error se traducen en las mismas configuraciones regionales que Visual Studio. NuGet.exe se distribuye como un solo exe y, debido a consideraciones de tamaño, solo los mensajes más expuestos se traducen en todos los idiomas.

  • Last updated on