Push-Befehl (NuGet CLI)

Gilt für: Paketveröffentlichung • Unterstützte Versionen: alle; 4.1.0+ für nuget.org

Wichtig

Um Pakete auf nuget.org zu veröffentlichen, müssen Sie nuget.exe v4.1.0+ verwenden, das die erforderlichen NuGet-Protokolle implementiert.

Verschiebt ein Paket an eine Paketquelle und veröffentlicht es.

Die Standardkonfiguration von NuGet wird durch Laden %AppData%\NuGet\NuGet.Config (Windows) oder ~/.nuget/NuGet/NuGet.Config (Mac/Linux) abgerufen. Anschließend werden alle Nuget.Config Dateien oder .nuget\Nuget.Config Dateien geladen, die vom Stamm des Laufwerks beginnen und im aktuellen Verzeichnis enden (siehe allgemeine NuGet-Konfigurationen)

Verbrauch

nuget push <packagePath> [options]

wobei <packagePath> das Paket angibt, das auf den Server übertragen werden soll.

Optionen

  • -ApiKey

    Der API-Schlüssel für das Ziel-Repository. Wenn sie nicht vorhanden ist, wird die in der Konfigurationsdatei angegebene Datei verwendet.

  • -ConfigFile

    Die NuGet-Konfigurationsdatei. Wenn nicht angegeben, %AppData%\NuGet\NuGet.Config (Windows) oder ~/.nuget/NuGet/NuGet.Config~/.config/NuGet/NuGet.Config (Mac/Linux) wird verwendet.

  • -DisableBuffering

    Deaktiviert die Pufferung bei Übertragungen an HTTP(S)-Server, um die Speicherauslastung zu verringern. Vorsicht: Wenn diese Option verwendet wird, funktionieren integrierte Windows-Authentifizierung möglicherweise nicht.

  • -ForceEnglishOutput

    (3.5+) Erzwingt die Ausführung der Anwendung mithilfe einer invarianten Kultur, die auf Englisch basiert.

  • -?|-help

    Druckt Hilfeinformationen für den Befehl.

  • -NonInteractive

    Fordert nicht zu Eingaben oder Bestätigungen des Benutzers auf.

  • -NoServiceEndpoint

    Fügt api/v2/packages nicht an die Quell-URL an.

  • -NoSymbols

    (3,5+) Wenn ein Symbolpaket vorhanden ist, wird es nicht an einen Symbolserver übertragen.

  • -src|-Source

    Gibt die Server-URL an. NuGet identifiziert eine UNC oder lokale Ordnerquelle und kopiert die Datei dorthin, anstatt sie mithilfe von HTTP zu pushen. Außerdem ist dies ab NuGet 3.4.2 ein obligatorischer Parameter, es sei denn, die NuGet.Config-Datei gibt einen DefaultPushSource-Wert an (siehe Konfigurieren des NuGet-Verhaltens).

  • -SkipDuplicate

    (5,1+) Wenn bereits ein Paket und eine Version vorhanden sind, überspringen Sie es, und fahren Sie ggf. mit dem nächsten Paket im Push fort. Diese Option wird ignoriert, wenn das Paket an eine UNC- oder lokale Ordnerquelle übertragen wird.

  • -SymbolSource

    Gibt die Symbolserver-URL an.

  • -SymbolApiKey

    (3.5+) Gibt den API-Schlüssel für die in -SymbolSource angegebene URL an.

  • -Timeout

    Gibt das Timeout für die Übertragung auf einen Server in Sekunden an. Der Standardwert beträgt 300 Sekunden (5 Minuten).

  • -Verbosity [normal|quiet|detailed]

    Gibt an, wie viele Details in der Ausgabe angezeigt werden: normal (der Standard), quiet oder detailed.

Weitere Informationen finden Sie unter Umgebungsvariablen

Beispiele

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