comando push (CLI do NuGet)

  • Artigo

Aplica-se a: publicação de pacotes • Versões suportadas: todas; 4.1.0 ou superior necessária para nuget.org

Importante

Para efetuar push em pacotes para o nuget.org, você precisa usar o nuget.exe v4.1.0 ou superior, que implementa os protocolos NuGet necessários.

Envia um pacote para uma origem de pacote e o publica.

A configuração padrão do NuGet é obtida carregando %AppData%\NuGet\NuGet.Config (Windows) ou ~/.nuget/NuGet/NuGet.Config (Mac/Linux) e, em seguida, carregando qualquer arquivo Nuget.Config ou .nuget\Nuget.Config que comece na raiz da unidade e termine no diretório atual (consulte Configurações comuns do NuGet)

Uso

nuget push <packagePath> [options]

em que <packagePath> identifica o pacote a ser enviado por push para o servidor.

Opções

  • -ApiKey

    A chave de API para o repositório de destino. Se não estiver presente, o especificado no arquivo de configuração será usado.

  • -ConfigFile

    O arquivo de configuração do NuGet a ser aplicado. Se não for especificado, %AppData%\NuGet\NuGet.Config (Windows), ~/.nuget/NuGet/NuGet.Config ou ~/.config/NuGet/NuGet.Config (Mac/Linux) será usado.

  • -DisableBuffering

    Desabilita o armazenamento em buffer ao enviar a um servidor HTTP(s) para diminuir o uso de memória. Cuidado: quando essa opção é usada, a autenticação integrada do Windows pode não funcionar.

  • -ForceEnglishOutput

    (3.5 ou superior) Força a execução de nuget.exe usando uma cultura invariável com base em inglês.

  • -?|-help

    Exibe as informações de ajuda para o comando.

  • -NonInteractive

    Suprime solicitações de entrada de usuário ou confirmações.

  • -NoServiceEndpoint

    Não anexa api/v2/packages à URL de origem.

  • -NoSymbols

    (3.5 ou superior) Se existir um pacote de símbolos, ele não será enviado por push para um servidor de símbolos.

  • -src|-Source

    Especifica a URL do servidor. O NuGet identifica uma fonte UNC ou pasta local e simplesmente copia o arquivo lá em vez de efetuá-lo por push usando HTTP. E também, do NuGet 3.4.2 em diante, esse é um parâmetro obrigatório, a menos que o arquivo NuGet.Config especifique um valor DefaultPushSource (consulte Configurar comportamento do NuGet).

  • -SkipDuplicate

    (5.1 ou superior) Se já existir um pacote e uma versão, ignore-o e continue com o próximo pacote no push, se houver. Essa opção será ignorada se o pacote estiver sendo enviado por push para uma origem de UNC ou pasta local.

  • -SymbolSource

    Especifica a URL do servidor de símbolos.

  • -SymbolApiKey

    (3.5 ou superior) Especifica a chave de API para a URL especificada em -SymbolSource.

  • -Timeout

    Especifica o tempo limite, em segundos, para enviar para um servidor. O padrão é 300 segundos (5 minutos).

  • -Verbosity [normal|quiet|detailed]

    Especifica a quantidade de detalhes exibida na saída: normal (o padrão), quiet ou detailed.

Confira também Variáveis de ambiente

Exemplos

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