Comando install (CLI de NuGet)

Se aplica a: consumo de paquetes • Versiones compatibles: todas

Descarga e instala un paquete en un proyecto, de forma predeterminada en la carpeta actual, mediante los orígenes de paquetes especificados.

Sugerencia

Para descargar un paquete directamente fuera del contexto de un proyecto, visite la página del paquete en nuget.org y seleccione el vínculo Descargar.

Si no se especifica ningún origen, se usan los enumerados en el archivo de configuración global, %appdata%\NuGet\NuGet.Config (Windows) o ~/.nuget/NuGet/NuGet.Config (Mac/Linux). Para conocer más detalles, consulte Configuraciones comunes de NuGet.

Si no se especifica ningún paquete, install instala todos los paquetes incluidos en el archivo packages.config del proyecto, de forma similar a restore.

El comando install no modifica ningún archivo del proyecto ni packages.config; en este sentido se parece a restore, ya que solo agrega paquetes al disco, sin cambiar las dependencias del proyecto.

Para agregar una dependencia, puede agregar un paquete mediante la interfaz de usuario del Administrador de paquetes o la consola en Visual Studio, o bien modificar packages.config y, luego, ejecutar install o restore.

Uso

nuget install <packageID | configFilePath> [options]

donde <packageID> asigna un nombre al paquete que se va a instalar (con la versión más reciente) o <configFilePath> identifica el archivo packages.config que enumera los paquetes que se van a instalar. Puede indicar una versión específica con la opción -Version.

Opciones

  • -ConfigFile

    El archivo de configuración de NuGet que aplicar. Si no se especifica, se usa %AppData%\NuGet\NuGet.Config (Windows) o ~/.nuget/NuGet/NuGet.Config o ~/.config/NuGet/NuGet.Config (Mac/Linux).

  • -DependencyVersion

    (4.4+) La versión de los paquetes de dependencia que se va a usar, que puede ser una de las siguientes:

    • Lowest (valor predeterminado): la versión más baja
    • HighestPatch: la versión con la revisión principal más baja, la secundaria más baja y la revisión más alta
    • HighestMinor: la versión con la revisión principal más baja, la secundaria más alta y la revisión más alta
    • Highest: la versión más alta
    • Ignore: no se usará ningún paquete de dependencia

  • -DirectDownload

    Descargue directamente sin rellenar las memorias caché con metadatos o archivos binarios.

  • -DisableParallelProcessing

    Deshabilita la instalación de varios paquetes en paralelo.

  • -x|-ExcludeVersion

    Instala el paquete en una carpeta denominada solo con el nombre del paquete y no el número de versión.

  • -FallbackSource

    (3.2+) Una lista de orígenes de paquetes que se van a usar como reserva en caso de que el paquete no se encuentre en el origen principal o predeterminado.

  • -ForceEnglishOutput

    (3.5 y posteriores) Fuerza la ejecución de nuget.exe mediante una referencia cultural en inglés invariable.

  • -Framework

    (4.4+) Plataforma de destino que se usa para seleccionar dependencias. Si no se especifica, se establece de forma predeterminada en "Any".

  • -?|-help

    Muestra información de ayuda para el comando.

  • -NoHttpCache

    Impide que NuGet use paquetes almacenados en caché http. Consulte Administración de paquetes globales y carpetas de caché.

  • -NonInteractive

    Suprime solicitudes de confirmaciones o de entrada de usuario.

  • -OutputDirectory

    Especifica la carpeta en la que se instalan los paquetes. Si no se especifica, se usa la carpeta actual.

  • -PackageSaveMode

    Especifica los tipos de archivos que se van a guardar después de la instalación del paquete: uno entre nuspec, nupkg o nuspec;nupkg.

  • -PreRelease

    Permite que se instalen paquetes de versión preliminar. Esta marca no es necesaria al restaurar paquetes con packages.config.

  • -RequireConsent

    Compruebe que la restauración de paquetes está habilitada antes de descargar e instalar los paquetes. Para obtener más información, consulte Restauración de paquetes.

  • -SolutionDirectory

    Especifica la carpeta raíz de la solución para la que se van a restaurar los paquetes.

  • -Source

    Especifica la lista de orígenes de paquete (como direcciones URL) que se van a usar. Si se omite, el comando usa los orígenes proporcionados en los archivos de configuración; consulta Configuraciones comunes de NuGet.

  • -Verbosity [normal|quiet|detailed]

    Especifica la cantidad de detalles que se muestran en la salida: normal (el valor predeterminado), quiet o detailed.

  • -Version

    Especifica la versión del paquete que se va a instalar.

Consulta también Variables de entorno

Ejemplos

nuget install elmah

nuget install packages.config

nuget install ninject -OutputDirectory c:\proj