Comando push (CLI de NuGet)

  • Artículo

Se aplica a: publicación de paquetes • Versiones compatibles: todas; 4.1.0 y posteriores necesarias para nuget.org

Importante

Para insertar paquetes en nuget.org, debes usar la versión 4.1.0 o una versión posterior de nuget.exe, que implementa los protocolos de NuGet necesarios.

Inserta un paquete en un origen de paquete y lo publica.

La configuración predeterminada de NuGet se obtiene cargando %AppData%\NuGet\NuGet.Config (Windows) o ~/.nuget/NuGet/NuGet.Config (Mac/Linux), cargando a continuación los archivos Nuget.Config o .nuget\Nuget.Config comenzando desde la carpeta raíz de la unidad y finalizando en el directorio actual (consulta Configuraciones comunes de NuGet)

Uso

nuget push <packagePath> [options]

donde <packagePath> identifica el paquete que se va a insertar en el servidor.

Opciones

  • -ApiKey

    Clave de API para el repositorio de destino. Si no está presente, se usa la especificada en el archivo de configuración.

  • -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).

  • -DisableBuffering

    Deshabilita el almacenamiento en búfer al realizar inserciones en un servidor HTTP(S) para disminuir el uso de memoria. Precaución: Cuando se usa esta opción, es posible que la autenticación integrada de Windows no funcione.

  • -ForceEnglishOutput

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

  • -?|-help

    Muestra información de ayuda para el comando.

  • -NonInteractive

    Suprime solicitudes de confirmaciones o de entrada de usuario.

  • -NoServiceEndpoint

    No anexa api/v2/packages a la dirección URL de origen.

  • -NoSymbols

    (3.5 y posteriores) Si existe un paquete de símbolos, no se insertará en un servidor de símbolos.

  • -src|-Source

    Especifica la dirección URL del servidor. NuGet identifica un origen de carpeta local o UNC y simplemente copia el archivo allí, en lugar de insertarlo mediante HTTP. Igualmente, a partir de NuGet 3.4.2, se trata de un parámetro obligatorio, a menos que el archivo NuGet.Config de NuGet especifique un valor DefaultPushSource (consulta Configuración del comportamiento de NuGet).

  • -SkipDuplicate

    (5.1 y posteriores) Si ya existe un paquete y una versión, omítelo y continúa con el siguiente paquete en la inserción, si existe. Esta opción se ignora si el paquete se inserta en un origen de carpeta UNC o local.

  • -SymbolSource

    Especifica la dirección URL del servidor de símbolos.

  • -SymbolApiKey

    (3.5 y posteriores) Especifica la clave de API para la dirección URL especificada en -SymbolSource.

  • -Timeout

    Especifica el tiempo de expiración para la inserción en un servidor. El valor predeterminado es 300 segundos (5 minutos).

  • -Verbosity [normal|quiet|detailed]

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

Consulta también Variables de entorno

Ejemplos

nuget push foo.nupkg

nuget push foo.symbols.nupkg

nuget push foo.nupkg -Timeout 360

nuget push *.nupkg

nuget.exe push -source \\mycompany\repo\ mypackage.1.0.0.nupkg

nuget push foo.nupkg 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -Source https://api.nuget.org/v3/index.json

nuget push foo.nupkg 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a

nuget push foo.nupkg 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -src https://customsource/

:: In the example below -SkipDuplicate will skip pushing the package if package "Foo" version "5.0.2" already exists on NuGet.org
nuget push Foo.5.0.2.nupkg 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -src https://api.nuget.org/v3/index.json -SkipDuplicate