NuGetCommand@2 – NuGet v2-Vorgang

Verwenden Sie diese Aufgabe, um NuGet-Pakete wiederherzustellen, zu packen oder zu pushen, oder führen Sie einen NuGet-Befehl aus. Diese Aufgabe unterstützt NuGet.org und authentifizierte Feeds wie Azure Artifacts und MyGet. Diese Aufgabe verwendet auch NuGet.exe und funktioniert mit .NET Framework-Apps. Verwenden Sie für .NET Core- und .NET Standard-Apps die .NET Core-Aufgabe.

Syntax

# NuGet v2
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Azure Artifacts and MyGet. Uses NuGet.exe and works with .NET Framework apps. For .NET Core and .NET Standard apps, use the .NET Core task.
- task: NuGetCommand@2
  inputs:
    command: 'restore' # 'restore' | 'pack' | 'push' | 'custom'. Required. Command. Default: restore.
    restoreSolution: '**/*.sln' # string. Alias: solution. Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.
    #nuGetFeedType: 'internal' # 'internal' | 'external'. Required when command = push. Target feed location. Default: internal.
    #publishVstsFeed: # string. Alias: feedPublish. Required when command = push && nuGetFeedType = internal. Target feed. 
    #allowPackageConflicts: false # boolean. Optional. Use when command = push && nuGetFeedType = internal. Allow duplicates to be skipped. Default: false.
    #publishFeedCredentials: # string. Alias: externalEndpoint. Required when command = push && nuGetFeedType = external. NuGet server. 
    #packagesToPack: '**/*.csproj' # string. Alias: searchPatternPack. Required when command = pack. Path to csproj or nuspec file(s) to pack. Default: **/*.csproj.
    #configuration: '$(BuildConfiguration)' # string. Alias: configurationToPack. Optional. Use when command = pack. Configuration to package. Default: $(BuildConfiguration).
    #packDestination: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package folder. Default: $(Build.ArtifactStagingDirectory).
    #arguments: # string. Required when command = custom. Command and arguments. 
  # Feeds and authentication
    feedsToUse: 'select' # 'select' | 'config'. Alias: selectOrConfig. Required when command = restore. Feeds to use. Default: select.
    #vstsFeed: # string. Alias: feedRestore. Optional. Use when selectOrConfig = select && command = restore. Use packages from this Azure Artifacts/TFS feed. Select from the dropdown or enter [project name/]feed name. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when selectOrConfig = config && command = restore. Credentials for feeds outside this organization/collection. 
  # Advanced
    #noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
    #disableParallelProcessing: false # boolean. Optional. Use when command = restore. Disable parallel processing. Default: false.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal. Publish pipeline metadata. Default: true.
    #verbosityPush: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = push. Verbosity. Default: Detailed.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #includeReferencedProjects: false # boolean. Optional. Use when versioningScheme = off && command = pack. Include referenced projects. Default: false.
    #versionEnvVar: # string. Required when versioningScheme = byEnvVar && command = pack. Environment variable. 
    #majorVersion: '1' # string. Alias: requestedMajorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Major. Default: 1.
    #minorVersion: '0' # string. Alias: requestedMinorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Minor. Default: 0.
    #patchVersion: '0' # string. Alias: requestedPatchVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Patch. Default: 0.
    #packTimezone: 'utc' # 'utc' | 'local'. Optional. Use when versioningScheme = byPrereleaseNumber && command = pack. Time zone. Default: utc.
    #includeSymbols: false # boolean. Optional. Use when command = pack. Create symbols package. Default: false.
    #toolPackage: false # boolean. Optional. Use when command = pack. Tool Package. Default: false.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #basePath: # string. Optional. Use when command = pack. Base path. 
    #verbosityPack: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = pack. Verbosity. Default: Detailed.

Eingänge

command - Command
string. Erforderlich. Zulässige Werte: restore, pack, push, custom. Standardwert: restore.

Gibt den auszuführenden NuGet-Befehl an. Verwenden Sie den custom Wert, um Argumente hinzuzufügen oder einen anderen Befehl zu verwenden.

restoreSolution - Pfad zu Lösung, packages.configoder project.json
Eingabealias: solution. string. Erforderlich, wenn command = restore. Standardwert: **/*.sln.

Gibt den Pfad zur Lösung, packages.configoder project.json Datei an, die auf die zu wiederherstellenden Pakete verweist.

feedsToUse - Feeds für die Verwendung von
Eingabealias: selectOrConfig. string. Erforderlich, wenn command = restore. Zulässige Werte: select (Feed(e) Ich wähle hier aus), config (Feeds in meinem NuGet.config). Standardwert: select.

Gibt einen Feed aus Azure Artifacts und/oder NuGet.org für die Aufgabe an, die mit dem select-Wert verwendet werden soll. Alternativ können Sie eine NuGet.config Datei in Ihr Quellcode-Repository übernehmen und den Pfad als Wert mit dem wert config festlegen.

vstsFeed - Pakete aus diesem Azure Artifacts/TFS-Feed verwenden. Wählen Sie aus der Dropdownliste aus, oder geben Sie [Projektname/]Feedname ein.
Eingabealias: feedRestore. string. Wahlfrei. Wird verwendet, wenn selectOrConfig = select && command = restore.

Gibt den ausgewählten Feed im generierten NuGet.configan. Sie müssen die Paketverwaltung installiert und lizenziert haben, um hier einen Feed anzugeben.

includeNuGetOrg - Verwenden von Paketen aus NuGet.org
boolean. Wahlfrei. Wird verwendet, wenn selectOrConfig = select && command = restore. Standardwert: true.

Enthält NuGet.org in die generierte NuGet.config.

nugetConfigPath - Pfad zu NuGet.config
string. Wahlfrei. Wird verwendet, wenn selectOrConfig = config && command = restore.

Gibt den Pfad zum NuGet.config in Ihrem Repository an, der die Feeds bestimmt, aus denen Pakete wiederhergestellt werden sollen.

externalFeedCredentials - Anmeldeinformationen für Feeds außerhalb dieser Organisation/Sammlung
Eingabealias: externalEndpoints. string. Wahlfrei. Wird verwendet, wenn selectOrConfig = config && command = restore.

Gibt die Anmeldeinformationen an, die für externe Registrierungen verwendet werden sollen, die sich in der ausgewählten NuGet.configbefinden. Dies ist der Name Ihrer NuGet-Dienstverbindung. Für Feeds in dieser Organisation oder Sammlung lassen Sie dieses Leerzeichen; die Anmeldeinformationen des Builds werden automatisch verwendet.

noCache - Deaktivieren des lokalen Caches
boolean. Wahlfrei. Wird verwendet, wenn command = restore. Standardwert: false.

Verhindert, dass NuGet Pakete von lokalen Computercaches verwendet, wenn diese auf truefestgelegt sind.

disableParallelProcessing - Parallelverarbeitung deaktivieren
boolean. Wahlfrei. Wird verwendet, wenn command = restore. Standardwert: false.

Verhindert, dass NuGet mehrere Pakete in parallelen Prozessen installiert, wenn diese auf truefestgelegt sind.

restoreDirectory - Zielverzeichnis
Eingabealias: packagesDirectory. string. Wahlfrei. Wird verwendet, wenn command = restore.

Gibt den Ordner an, in dem Pakete installiert werden. Wenn kein Ordner angegeben ist, werden Pakete zusammen mit der ausgewählten Lösung, packages/oder packages.configin einem project.json Ordner wiederhergestellt.

verbosityRestore - Ausführlichkeit
string. Wahlfrei. Wird verwendet, wenn command = restore. Zulässige Werte: Quiet, Normal, Detailed. Standardwert: Detailed.

Gibt die Menge an Details an, die in der Ausgabe angezeigt werden.

packagesToPush - Pfad zu NuGet-Paketen zum Veröffentlichen von
Eingabealias: searchPatternPush. string. Erforderlich, wenn command = push. Standardwert: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.

Gibt das Muster an, das mit nupkg hochzuladenden Dateien abgeglichen werden soll. Mehrere Muster können durch ein Semikolon getrennt werden.

nuGetFeedType - Zielfeedspeicherort
string. Erforderlich, wenn command = push. Zulässige Werte: internal (Diese Organisation/Sammlung), external (externer NuGet-Server (einschließlich anderer Konten/Sammlungen)). Standardwert: internal.

Gibt an, ob der Zielfeed ein interner Feed/eine interne Auflistung oder ein externer NuGet-Server ist.

publishVstsFeed - Zielfeed-
Eingabealias: feedPublish. string. Erforderlich, wenn command = push && nuGetFeedType = internal.

Gibt einen feed an, der in diesem Konto gehostet wird. Sie müssen Azure Artifacts installiert und lizenziert haben, um hier einen Feed auszuwählen.

publishPackageMetadata - Veröffentlichen von Pipelinemetadaten
boolean. Wahlfrei. Wird verwendet, wenn command = push && nuGetFeedType = internal. Standardwert: true.

Ändert die Versionsnummer der Teilmenge der geänderten Pakete innerhalb einer Reihe kontinuierlich veröffentlichter Pakete.

allowPackageConflicts - Zulassen, dass Duplikate übersprungen werden
boolean. Wahlfrei. Wird verwendet, wenn command = push && nuGetFeedType = internal. Standardwert: false.

Meldet den Vorgangserfolg, auch wenn einige Ihrer Pakete mit 409 Konfliktfehlern abgelehnt werden.

Diese Option ist derzeit nur für Azure-Pipelines und Windows-Agents verfügbar. Wenn NuGet.exe einen Konflikt findet, schlägt die Aufgabe fehl. Diese Option funktioniert nicht, und die Veröffentlichung schlägt fehl, wenn Sie sich in einer Proxyumgebung befinden.

publishFeedCredentials - NuGet-Server-
Eingabealias: externalEndpoint. string. Erforderlich, wenn command = push && nuGetFeedType = external.

Gibt die NuGet-Dienstverbindung an, die die Anmeldeinformationen des externen NuGet-Servers enthält.

verbosityPush - Ausführlichkeit
string. Wahlfrei. Wird verwendet, wenn command = push. Zulässige Werte: Quiet, Normal, Detailed. Standardwert: Detailed.

Gibt die Menge an Details an, die in der Ausgabe angezeigt werden.

packagesToPack - Pfad zu csproj- oder nuspec-Dateien zum Packen
Eingabealias: searchPatternPack. string. Erforderlich, wenn command = pack. Standardwert: **/*.csproj.

Gibt das Muster an, das von der Aufgabe zum Suchen nach csproj-Verzeichnissen zum Packen verwendet wird.

Sie können mehrere Muster durch ein Semikolon trennen, und Sie können ein Muster negativ machen, indem Sie es mit !voranstellen. Beispiel: **\*.csproj;!**\*.Tests.csproj.

configuration - Konfiguration zum Packen
Eingabealias: configurationToPack. string. Wahlfrei. Wird verwendet, wenn command = pack. Standardwert: $(BuildConfiguration).

Gibt die Konfiguration an, die bei Verwendung einer csproj-Datei verpackt werden soll.

packDestination - Paketordner
Eingabealias: outputDir. string. Wahlfrei. Wird verwendet, wenn command = pack. Standardwert: $(Build.ArtifactStagingDirectory).

Gibt den Ordner an, in dem die Aufgabe Pakete erstellt. Wenn der Wert leer ist, erstellt die Aufgabe Pakete im Quellstamm.

versioningScheme - automatische Paketversionsverwaltung
string. Erforderlich, wenn command = pack. Zulässige Werte: off, byPrereleaseNumber (Datum und Uhrzeit verwenden), byEnvVar (Umgebungsvariable verwenden), byBuildNumber (Buildnummer verwenden). Standardwert: off.

Wendet die automatische Paketversionsverwaltung abhängig vom angegebenen Wert an. Diese Zeichenfolge kann nicht mit includeReferencedProjectsverwendet werden. Die zulässigen Werte sind:

• byPrereleaseNumber - Verwenden Sie das Datum und die Uhrzeit: Die Aufgabe generiert eine SemVer--kompatible Version, die als X.Y.Z-ci-datetimeformatiert ist, wobei Sie die Werte von X, Y und Z angeben.
• byEnvVar - Verwenden Sie eine Umgebungsvariable: Die Aufgabe verwendet eine Umgebungsvariable, die Sie angeben und die Versionsnummer enthält, die Sie verwenden möchten.
• byBuildNumber - Verwenden Sie die Buildnummer: Die Aufgabe verwendet die Buildnummer, um das Paket zu versionieren.

Anmerkung

Legen Sie unter "Allgemein" das Buildformat auf $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)fest.

includeReferencedProjects - Einschließen von referenzierten Projekten
boolean. Wahlfrei. Wird verwendet, wenn versioningScheme = off && command = pack. Standardwert: false.

Enthält referenzierte Projekte entweder als Abhängigkeiten oder als Teil des Pakets. Kann nicht mit der automatischen Paketversionsverwaltung verwendet werden. Wenn ein referenziertes Projekt über eine entsprechende nuspec Datei mit demselben Namen wie das Projekt verfügt, wird das referenzierte Projekt als Abhängigkeit hinzugefügt. Andernfalls wird das referenzierte Projekt als Teil des Pakets hinzugefügt. Erfahren Sie mehr über mithilfe des Paketbefehls für NuGet CLI zum Erstellen von NuGet-Paketen.

versionEnvVar - Umgebungsvariablen
string. Erforderlich, wenn versioningScheme = byEnvVar && command = pack.

Gibt den Variablennamen ohne $, $envoder %an.

majorVersion - Haupt-
Eingabealias: requestedMajorVersion. string. Erforderlich, wenn versioningScheme = byPrereleaseNumber && command = pack. Standardwert: 1.

Die X in Version X.Y.Z.

minorVersion - neben
Eingabealias: requestedMinorVersion. string. Erforderlich, wenn versioningScheme = byPrereleaseNumber && command = pack. Standardwert: 0.

Die Y in Version X.Y.Z.

patchVersion - Patch-
Eingabealias: requestedPatchVersion. string. Erforderlich, wenn versioningScheme = byPrereleaseNumber && command = pack. Standardwert: 0.

Die Z in Version X.Y.Z.

packTimezone - Zeitzone
string. Wahlfrei. Wird verwendet, wenn versioningScheme = byPrereleaseNumber && command = pack. Zulässige Werte: utc, local (Ortszeit des Agents). Standardwert: utc.

Gibt die gewünschte Zeitzone an, die zur Erstellung der Version des Pakets verwendet wird. Die Auswahl utc wird empfohlen, wenn Sie gehostete Build-Agents verwenden, da sich das Datum und die Uhrzeit möglicherweise unterscheiden.

includeSymbols - Symbolpaket erstellen
boolean. Wahlfrei. Wird verwendet, wenn command = pack. Standardwert: false.

Gibt an, dass das Paket Quellen und Symbole enthält. Bei Verwendung mit einer .nuspec Datei erstellt dies eine normale NuGet-Paketdatei und das entsprechende Symbolpaket.

toolPackage - Toolpaket-
boolean. Wahlfrei. Wird verwendet, wenn command = pack. Standardwert: false.

Bestimmt, ob sich die Ausgabedateien des Projekts im Toolordner befinden sollen.

buildProperties - Zusätzliche Buildeigenschaften
string. Wahlfrei. Wird verwendet, wenn command = pack.

Gibt eine Liste von Token=Wertpaaren an, getrennt durch Semikolons, wobei jedes Vorkommen von $token$ in der .nuspec Datei durch den angegebenen Wert ersetzt wird. Werte können Zeichenfolgen in Anführungszeichen sein.

basePath - Basispfad
string. Wahlfrei. Wird verwendet, wenn command = pack.

Gibt den Basispfad der in der nuspec Datei definierten Dateien an.

verbosityPack - Ausführlichkeit
string. Wahlfrei. Wird verwendet, wenn command = pack. Zulässige Werte: Quiet, Normal, Detailed. Standardwert: Detailed.

Gibt die Menge an Details an, die in der Ausgabe angezeigt werden.

arguments - Befehl und Argumente
string. Erforderlich, wenn command = custom.

Gibt den Befehl und die Argumente an, die zur Ausführung an NuGet.exe übergeben werden. Wenn NuGet 3.5 oder höher verwendet wird, werden authentifizierte Befehle wie list, restoreund publish für jeden Feed in dieser Organisation oder Sammlung, auf den der Project Collection Build Service Zugriff hat, automatisch authentifiziert.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Nichts.

Bemerkungen

Wichtig

Die NuGet Authenticate Aufgabe ist die neue empfohlene Methode zum Authentifizieren mit Azure Artifacts und anderen NuGet-Repositorys. Diese Aufgabe übernimmt keine neuen Features mehr, und nur kritische Fehler werden behoben.

Verwenden Sie diese Aufgabe zum Installieren und Aktualisieren von NuGet-Paketabhängigkeiten oder zum Verpacken und Veröffentlichen von NuGet-Paketen. Verwendet NuGet.exe und funktioniert mit .NET Framework-Apps. Verwenden Sie für .NET Core- und .NET Standard-Apps die .NET Core-Aufgabe.

Wenn Ihr Code von NuGet-Paketen abhängt, müssen Sie diesen Schritt vor der Visual Studio Build-Aufgabehinzufügen. Deaktivieren Sie außerdem das Kontrollkästchen "Veraltete NuGet-Pakete wiederherstellen" in dieser Aufgabe.

Wenn Sie mit .NET Core oder .NET Standard arbeiten, verwenden Sie die aufgabe .NET Core, die vollständige Unterstützung für alle Paketszenarien hat und derzeit von dotnet unterstützt wird.

Trinkgeld

Diese Version der NuGet-Aufgabe verwendet Standardmäßig NuGet 4.1.0. Um eine andere Version von NuGet auszuwählen, verwenden Sie das Tool Installer.

Versionsverwaltungsschemas

Für byPrereleaseNumberwird die Version auf die Werte festgelegt, die Sie für die Hauptversion, die Nebenversion und den Patch sowie das Datum und die Uhrzeit im Format yyyymmdd-hhmmssauswählen.

Für byEnvVarwird die Version auf den Wert der Umgebungsvariable festgelegt, deren Name durch den parameter versionEnvVar angegeben ist, z. B. MyVersion (kein $, nur der Name der Umgebungsvariable). Stellen Sie sicher, dass die Umgebungsvariable auf ein richtiges SemVer festgelegt ist, z. B. 1.2.3 oder 1.2.3-beta1.

Für byBuildNumberwird die Version mithilfe der Buildnummer der Pipelineausführung festgelegt. Dies ist der für die name-Eigenschaft der Pipeline angegebene Wert, der in der BUILD_BUILDNUMBER Umgebungsvariable gespeichert wird). Stellen Sie sicher, dass die verwendete Buildnummer ein ordnungsgemäßes SemVer enthält, z. B. 1.0.$(Rev:r). Bei Verwendung von byBuildNumberextrahiert die Aufgabe die gepunktete Version, 1.2.3.4, aus der Buildnummerzeichenfolge, und verwenden Sie nur diesen Teil. Der Rest der Zeichenfolge wird gelöscht. Wenn Sie die Buildnummer wie folgt verwenden möchten, können Sie byEnvVar wie oben beschrieben verwenden und versionEnvVar auf BUILD_BUILDNUMBERfestlegen.

Migrieren von NuGetInstaller@0 oder NuGetRestore@1

NuGetInstaller@0 und NuGetRestore@1 sind veraltet, und Sie sollten sie in Ihrer Pipeline durch NuGetCommand@2ersetzen.

Wenn Sie NuGetInstaller@0 mit restoreMode: restoreverwendet haben, konfigurieren Sie die folgenden Eingaben bei Verwendung von NuGetCommand@2.

NuGetCommand@2 Aufgabeneingabe	Wert
command	restore
restoreSolution	Pfad der .sln-Datei

Wenn Sie NuGetInstaller@0 mit restoreMode: installverwendet haben, konfigurieren Sie die folgenden Eingaben bei Verwendung von NuGetCommand@2.

NuGetCommand@2 Aufgabeneingabe	Wert
command	custom
arguments	Wie der vollständige Installationsbefehl in der NuGet CLI aussehen würde. Wenn Sie beispielsweise das Äquivalent von nuget install ninject -OutputDirectory c:\proj in Der Pipeline ausführen möchten, wäre der arguments Parameter install ninject -OutputDirectory c:\proj. Wenn Sie den parameter NuGetInstaller@0nuGetRestoreArgs verwenden, gehen Sie jetzt auch in arguments.

Wenn Sie NuGetRestore@1verwendet haben, konfigurieren Sie bei Verwendung von NuGetCommand@2die folgenden Eingaben.

NuGetCommand@2 Aufgabeneingabe	Wert
command	restore
restoreSolution	Pfad der .sln-Datei

Ähnlich wie bei der Verwendung von NuGetRestore@1 oder der option NuGetInstaller@0restore verfügt NuGetCommand@2 über Eingaben zum Festlegen des Feeds, entscheiden zwischen select oder config, geben Sie den Pfad zur NuGet.config Datei an, und verwenden Sie Pakete aus nuget.org.

Weitere Informationen finden Sie in den folgenden Beispielen.

Unterstützung für neuere ubuntu gehostete Bilder

Ab Ubuntu 24.04 werden von Microsft gehostete Agents nicht mit Mono- ausgeliefert, die zum Ausführen des zugrunde liegenden NuGet-Clients erforderlich sind, der NuGetCommand@2. Benutzer dieser Aufgabe auf Ubuntu sollten zu der langfristig unterstützten plattformübergreifenden Aufgabe NuGetAuthenticate@1 mit .NET CLI migrieren.

Migrieren zu .NET CLI unter Ubuntu

Die NuGet Authenticate Aufgabe verarbeitet das Einfügen von Anmeldeinformationen an die erforderlichen Stellen, damit Clienttools sich als Pipelineidentität authentifizieren können. In der verknüpften Dokumentation finden Sie Anweisungen, HÄUFIG gestellte Fragen und Beispiele für die Verwendung von NuGet Authenticate mit dotnet.

Wenn dotnet CLI-Befehle Ihr Szenario nicht unterstützen, melden Sie dies dem .NET CLI-Team als Problem. Möglicherweise Sie Ihr Agent-Image an Ubuntu 22.04 oder früherenanheften. Der Ubuntu 22.04-Support wird fortgesetzt, bis Ubuntu 26.04 allgemein verfügbar gemacht wird, nicht früher als 2026.

Beispiele

Wiederherstellen

Stellen Sie alle Ihre Lösungen mit Paketen aus einem ausgewählten Feed wieder her.

# Restore from a project scoped feed in the same organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-project/my-project-scoped-feed'
    includeNuGetOrg: false
    restoreSolution: '**/*.sln'

# Restore from an organization scoped feed in the same organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-organization-scoped-feed'
    restoreSolution: '**/*.sln'

# Restore from a feed in a different organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: config
    nugetConfigPath: ./nuget.config
    restoreSolution: '**/*.sln'
    externalFeedCredentials: 'MyServiceConnectionName'
    noCache: true
  continueOnError: true

# Restore from feed(s) set in nuget.config
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'config'
    nugetConfigPath: 'nuget.config'

Paket

Erstellen Sie ein NuGet-Paket im Zielordner.

# Package a project
- task: NuGetCommand@2
  inputs:
    command: 'pack'
    packagesToPack: '**/*.csproj'
    packDestination: '$(Build.ArtifactStagingDirectory)'

Drücken

Anmerkung

Pipelineartefakte werden in das verzeichnis Pipeline.Workspace und in das System.ArtifactsDirectory Verzeichnis für klassische Releasepipelines heruntergeladen. packagesToPush Wert kann auf $(Pipeline.Workspace)/**/*.nupkg oder $(System.ArtifactsDirectory)/**/*.nupkg festgelegt werden.

• Push/Publish a package to a feed defined in your NuGet.config.

  # Push a project
  - task: NuGetCommand@2
    inputs:
      command: 'push'
      packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg'
      feedsToUse: 'config'
      nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
  

• Pushen/Veröffentlichen eines Pakets in einem bezogenen Feed einer Organisation

  # Push a project
  - task: NuGetCommand@2
    inputs:
      command: 'push'
      nuGetFeedType: 'internal'
      publishVstsFeed: 'my-organization-scoped-feed'
  

• Pushen/Veröffentlichen eines Pakets in einem Projektbereichsfeed

  # Push a project
  - task: NuGetCommand@2
    inputs:
      command: 'push'
      nuGetFeedType: 'internal'
      publishVstsFeed: 'my-project/my-project-scoped-feed'
  

• Pushen/Veröffentlichen eines Pakets auf NuGet.org

  # Push a project
  - task: NuGetCommand@2
    inputs:
      command: 'push'
      feedsToUse: 'config'
      includeNugetOrg: 'true'
  

Gewohnheit

Führen Sie alle anderen NuGet-Befehle neben den Standardbefehlen aus: Packen, Pushen und Wiederherstellen.

# list local NuGet resources.
- task: NuGetCommand@2
  displayName: 'list locals'
  inputs:
    command: custom
    arguments: 'locals all -list'

Anforderungen

Anforderung	Beschreibung
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	2.144.0 oder höher
Vorgangskategorie	Paket