Dela via

NuGetCommand@2 – NuGet v2-uppgift

Använd den här uppgiften för att återställa, packa eller push-överföra NuGet-paket eller köra ett NuGet-kommando. Den här uppgiften stöder NuGet.org och autentiserade feeds som Azure Artifacts och MyGet. Den här uppgiften använder också NuGet.exe och fungerar med .NET Framework-appar. För .NET Core- och .NET Standard-appar använder du .NET Core-uppgiften.

Tip

Använd NuGetAuthenticate@1 i din pipeline före den här uppgiften. Mer information finns i Varför misslyckas min bygg-pipeline och frågar efter autentisering med enkel Sign-On (SSO?).

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.

# 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. 
    #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.

Inputs

command - Befallning
string. Required. Tillåtna värden: restore, pack, push, custom. Standardvärde: restore.

Anger det NuGet-kommando som ska köras. Använd värdet custom för att lägga till argument eller för att använda ett annat kommando.


restoreSolution - Sökväg till lösning, packages.configeller project.json
Alias för inmatning: solution. string. Krävs när command = restore. Standardvärde: **/*.sln.

Anger sökvägen till lösningen, packages.configeller project.json fil som refererar till de paket som ska återställas.


feedsToUse - feeds för att använda
Alias för inmatning: selectOrConfig. string. Krävs när command = restore. Tillåtna värden: select (feeds) som jag väljer här), config (feeds i min NuGet.config). Standardvärde: select.

Anger ett flöde från Azure Artifacts och/eller NuGet.org för uppgiften som ska användas med värdet select. Du kan också checka in en NuGet.config fil till källkodslagringsplatsen och ange dess sökväg som värdet med hjälp av config-värdet.


vstsFeed - Använd paket från den här Azure Artifacts/TFS-feeden. Välj i listrutan eller ange [projektnamn/]feednamn.
Alias för inmatning: feedRestore. string. Optional. Använd när selectOrConfig = select && command = restore.

Anger den valda feeden i den genererade NuGet.config. Du måste ha Pakethantering installerat och licensierat för att kunna ange en feed här.


vstsFeed - Använd paket från den här Azure Artifacts/TFS-feeden
Alias för inmatning: feedRestore. string. Optional. Använd när selectOrConfig = select && command = restore.

Anger den valda feeden i den genererade NuGet.config. Du måste ha Pakethantering installerat och licensierat för att kunna ange en feed här.


includeNuGetOrg - Använd paket från NuGet.org
boolean. Optional. Använd när selectOrConfig = select && command = restore. Standardvärde: true.

Innehåller NuGet.org i den genererade NuGet.config.


nugetConfigPath - sökväg till NuGet.config
string. Optional. Använd när selectOrConfig = config && command = restore.

Anger sökvägen till NuGet.config på lagringsplatsen som avgör vilka feeds som paketen ska återställas från.


externalFeedCredentials - Autentiseringsuppgifter för feeds utanför organisationen/samlingen
Alias för inmatning: externalEndpoints. string. Optional. Använd när selectOrConfig = config && command = restore.

Anger de autentiseringsuppgifter som ska användas för externa register som finns i den valda NuGet.config. Det här är namnet på din NuGet-tjänstanslutning. Lämna detta tomt för feeds i den här organisationen eller samlingen. byggets autentiseringsuppgifter används automatiskt.


noCache - Inaktivera lokal cache
boolean. Optional. Använd när command = restore. Standardvärde: false.

Hindrar NuGet från att använda paket från lokala datorcacheminnen när det är inställt på true.


disableParallelProcessing - Inaktivera parallell bearbetning
boolean. Optional. Använd när command = restore. Standardvärde: false.

Hindrar NuGet från att installera flera paket i parallella processer när det är inställt på true.


restoreDirectory - Mål-katalog
Alias för inmatning: packagesDirectory. string. Optional. Använd när command = restore.

Anger mappen där paket installeras. Om ingen mapp anges återställs paketen till en packages/ mapp tillsammans med den valda lösningen, packages.configeller project.json.


verbosityRestore - Informationsnivån
string. Optional. Använd när command = restore. Tillåtna värden: Quiet, Normal, Detailed. Standardvärde: Detailed.

Anger mängden information som visas i utdata.


packagesToPush - sökväg till NuGet-paket för att publicera
Alias för inmatning: searchPatternPush. string. Krävs när command = push. Standardvärde: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.

Anger det mönster som ska matchas eller sökvägen till nupkg filer som ska laddas upp. Flera mönster kan avgränsas med ett semikolon.


nuGetFeedType - Målflödesplats
string. Krävs när command = push. Tillåtna värden: internal (den här organisationen/samlingen), external (extern NuGet-server (inklusive andra konton/samlingar)). Standardvärde: internal.

Anger om målflödet är en intern feed/samling eller en extern NuGet-server.


publishVstsFeed - Målflöde
Alias för inmatning: feedPublish. string. Krävs när command = push && nuGetFeedType = internal.

Anger ett flöde som finns i det här kontot. Du måste ha Azure Artifacts installerat och licensierat för att välja en feed här.


publishPackageMetadata - Publicera pipelinemetadata
boolean. Optional. Använd när command = push && nuGetFeedType = internal. Standardvärde: true.

Ändrar versionsnumret för delmängden av ändrade paket i en uppsättning kontinuerligt publicerade paket.


allowPackageConflicts - Tillåt att dubbletter hoppas över
boolean. Optional. Använd när command = push && nuGetFeedType = internal. Standardvärde: false.

Rapporterar aktivitetsframgång även om vissa av paketen avvisas med 409 Konfliktfel.

Det här alternativet är för närvarande endast tillgängligt för Azure Pipelines- och Windows-agenter. Om NuGet.exe stöter på en konflikt misslyckas uppgiften. Det här alternativet fungerar inte och publiceringen misslyckas om du befinner dig i en proxymiljö.


publishFeedCredentials - NuGet-server
Alias för inmatning: externalEndpoint. string. Krävs när command = push && nuGetFeedType = external.

Anger NuGet-tjänstanslutningen som innehåller den externa NuGet-serverns autentiseringsuppgifter.


verbosityPush - Informationsnivån
string. Optional. Använd när command = push. Tillåtna värden: Quiet, Normal, Detailed. Standardvärde: Detailed.

Anger mängden information som visas i utdata.


packagesToPack - Sökväg till csproj- eller nuspec-filer för att packa
Alias för inmatning: searchPatternPack. string. Krävs när command = pack. Standardvärde: **/*.csproj.

Anger det mönster som aktiviteten använder för att söka efter csproj-kataloger som ska packas.

Du kan separera flera mönster med ett semikolon och du kan göra ett mönster negativt genom att prefixera det med !. Exempel: **\*.csproj;!**\*.Tests.csproj.


configuration - Konfiguration för att paketera
Alias för inmatning: configurationToPack. string. Optional. Använd när command = pack. Standardvärde: $(BuildConfiguration).

Anger vilken konfiguration som ska paketeras när du använder en csproj-fil.


packDestination - Mapp för paket
Alias för inmatning: outputDir. string. Optional. Använd när command = pack. Standardvärde: $(Build.ArtifactStagingDirectory).

Anger mappen där uppgiften skapar paket. Om värdet är tomt skapar aktiviteten paket i källroten.


versioningScheme - Automatisk versionshantering av paket
string. Krävs när command = pack. Tillåtna värden: off, byPrereleaseNumber (Använd datum och tid), byEnvVar (Använd en miljövariabel), byBuildNumber (Använd versionsnumret). Standardvärde: off.

Tillämpar automatisk paketversionshantering beroende på det angivna värdet. Det går inte att använda den här strängen med includeReferencedProjects. De tillåtna värdena är:

  • byPrereleaseNumber - Använd datum och tid: Uppgiften genererar en SemVer-kompatibel version formaterad som X.Y.Z-ci-datetime, där du anger värdena för X, Y och Z.
  • byEnvVar - Använd en miljövariabel: Uppgiften använder en miljövariabel som du anger och innehåller det versionsnummer som du vill använda.
  • byBuildNumber - Använd versionsnumret: Uppgiften använder versionsnumret för paketet.

Note

Under Allmänt anger du byggformatet till $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).


includeReferencedProjects - Inkludera refererade projekt
boolean. Optional. Använd när versioningScheme = off && command = pack. Standardvärde: false.

Innehåller refererade projekt antingen som beroenden eller som en del av paketet. Det går inte att använda med automatisk paketversionshantering. Om ett refererat projekt har en motsvarande nuspec fil som har samma namn som projektet läggs det refererade projektet till som ett beroende. Annars läggs det refererade projektet till som en del av paketet. Läs mer om med hjälp av paketkommandot för NuGet CLI för att skapa NuGet-paket.


versionEnvVar - Miljövariabel
string. Krävs när versioningScheme = byEnvVar && command = pack.

Anger variabelnamnet utan $, $enveller %.


majorVersion - Major
Alias för inmatning: requestedMajorVersion. string. Krävs när versioningScheme = byPrereleaseNumber && command = pack. Standardvärde: 1.

Den X i version X.Y.Z.


minorVersion - Underårig
Alias för inmatning: requestedMinorVersion. string. Krävs när versioningScheme = byPrereleaseNumber && command = pack. Standardvärde: 0.

Den Y i version X.Y.Z.


patchVersion - Lapp
Alias för inmatning: requestedPatchVersion. string. Krävs när versioningScheme = byPrereleaseNumber && command = pack. Standardvärde: 0.

Den Z i version X.Y.Z.


packTimezone - Tidszon
string. Optional. Använd när versioningScheme = byPrereleaseNumber && command = pack. Tillåtna värden: utc, local (lokal agenttid). Standardvärde: utc.

Anger önskad tidszon som används för att skapa versionen av paketet. Du bör välja utc om du använder värdbaserade byggagenter eftersom datum och tid kan skilja sig åt.


includeSymbols - Skapa symbolpaket
boolean. Optional. Använd när command = pack. Standardvärde: false.

Anger att paketet innehåller källor och symboler. När den används med en .nuspec fil skapas en vanlig NuGet-paketfil och motsvarande symbolpaket.


toolPackage - Verktyg Paket
boolean. Optional. Använd när command = pack. Standardvärde: false.

Avgör om utdatafilerna för projektet ska finnas i verktygsmappen.


buildProperties - Ytterligare byggegenskaper
string. Optional. Använd när command = pack.

Anger en lista över token=värdepar, avgränsade med semikolon, där varje förekomst av $token$ i .nuspec-filen ersätts med det angivna värdet. Värden kan vara strängar inom citattecken.


basePath - Grundläggande sökväg
string. Optional. Använd när command = pack.

Anger bassökvägen för de filer som definierats i nuspec-filen.


verbosityPack - Informationsnivån
string. Optional. Använd när command = pack. Tillåtna värden: Quiet, Normal, Detailed. Standardvärde: Detailed.

Anger mängden information som visas i utdata.


arguments - kommando och argument
string. Krävs när command = custom.

Anger kommandot och argumenten som ska skickas till NuGet.exe för körning. Om NuGet 3.5 eller senare används autentiserade kommandon som list, restoreoch publish mot alla feeds i den här organisationen eller samlingen som Project Collection Build Service har åtkomst till autentiseras automatiskt.


Alternativ för aktivitetskontroll

Alla aktiviteter har kontrollalternativ utöver sina uppgiftsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

None.

Remarks

Important

Om du vill autentisera med Azure Artifacts eller andra NuGet-lagringsplatser måste du använda NuGet Authenticate-uppgiften i stället för uppgiften NuGetCommand@2 . Uppgiften NuGetCommand@2 uppdateras inte längre med nya funktioner, endast kritiska buggar åtgärdas.

Använd den här uppgiften för att återställa, packa eller skicka NuGet-paket eller köra NuGet-kommandon. Den här uppgiften använder NuGet.exe och fungerar med .NET Framework appar. Om du arbetar med .NET Core eller .NET Standard använder du .NET Core-uppgiften , som har fullständigt stöd för alla paketscenarier och för närvarande stöds av dotnet.

Om din kod är beroende av NuGet-paket och du behöver återställa dessa beroenden innan du skapar projektet med Visual Studio Build-uppgiftsuppgiften kan du använda nugetAuthenticate - och kommandoradsuppgifterna för att återställa dina paket. Placera båda uppgifterna före byggsteget för att säkerställa att alla beroenden är tillgängliga innan bygget startar. Mer information finns i Återställa NuGet-paket .

När du använder Visual Studio Build-uppgiftsuppgiften måste du lämna argumentet restoreNugetPackages tomt, eftersom alternativet "Återställ NuGet-paket" är inaktuellt i den VSBuild@1 uppgiften.

Tip

Den här versionen av NuGet-aktiviteten använder NuGet 4.1.0 som standard. Om du vill välja en annan version av NuGet använder du installationsprogrammet för verktyget.

Versionshanteringsscheman

För byPrereleaseNumber anges versionen till de värden som du väljer för huvudversionen, delversionen och korrigeringsfilen, plus datum och tid, i formatet yyyymmdd-hhmmss.

För byEnvVar anges versionen till värdet för miljövariabeln som har det namn som anges av parametern versionEnvVar , t.ex. MyVersion (no $, bara miljövariabelns namn). Kontrollera att miljövariabeln är inställd på en korrekt SemVer, till exempel 1.2.3 eller 1.2.3-beta1.

För byBuildNumber anges versionen med hjälp av pipelinekörningens byggnummer. Det här är det värde som anges för pipelinens name egenskap, som sparas i BUILD_BUILDNUMBER miljövariabeln). Kontrollera att versionsnumret som används innehåller en korrekt SemVer, till exempel 1.0.$(Rev:r). När du använder byBuildNumber extraherar uppgiften den prickade versionen, 1.2.3.4, från byggnummersträngen och använder endast den delen. Resten av strängen tas bort. Om du vill använda versionsnumret som det är kan du använda byEnvVar enligt beskrivningen ovan och ange versionEnvVar till BUILD_BUILDNUMBER.

Migrera från NuGetInstaller@0 eller NuGetRestore@1

NuGetInstaller@0 och NuGetRestore@1 är inaktuella och du bör ersätta dem i pipelinen med NuGetCommand@2.

Om du använde NuGetInstaller@0 med restoreMode: restorekonfigurerar du följande indata när du använder NuGetCommand@2.

NuGetCommand@2 aktivitetsindata Value
command restore
restoreSolution Sök efter .sln-filen

Om du använde NuGetInstaller@0 med restoreMode: installkonfigurerar du följande indata när du använder NuGetCommand@2.

NuGetCommand@2 aktivitetsindata Value
command custom
arguments Hur det fullständiga installationskommandot skulle se ut i NuGet CLI. Om du till exempel vill köra motsvarande nuget install ninject -OutputDirectory c:\proj i pipelinen är parametern argumentsinstall ninject -OutputDirectory c:\proj. Om du använder parametern NuGetInstaller@0nuGetRestoreArgs går dessa nu också in arguments.

Om du använde NuGetRestore@1konfigurerar du följande indata när du använder NuGetCommand@2.

NuGetCommand@2 aktivitetsindata Value
command restore
restoreSolution Sök efter .sln-filen

På samma sätt som med alternativet NuGetRestore@1 eller NuGetInstaller@0restore har NuGetCommand@2 indata för att ange feeden, bestämma mellan select eller config, ange sökvägen till filen NuGet.config och använda paket från nuget.org.

Mer information finns i följande exempel.

Stöd för nyare Ubuntu-värdbaserade avbildningar

Från och med Ubuntu 24.04 levereras inte Microsft-värdbaserade agenter med mono- som krävs för att köra den underliggande NuGet-klienten som driver NuGetCommand@2. Användare av den här uppgiften på Ubuntu bör migrera till den långsiktiga plattformsoberoende uppgift NuGetAuthenticate@1 med .NET CLI.

Migrera till .NET CLI på Ubuntu

Uppgiften NuGet Authenticate hanterar inmatning av autentiseringsuppgifter på de platser som behövs för att klientverktyg ska kunna autentiseras som din pipelineidentitet. Se avsnitten Exempel och Kommentarer för att lära dig mer om hur du använder NuGet Authenticate med dotnet.

Om dotnet CLI-kommandon inte stöder ditt scenario rapportera detta till .NET CLI-teamet som ett problem. Du kan fortsätta att fästa agentbilden på Ubuntu 22.04 eller tidigare. Ubuntu 22.04-supporten fortsätter tills Ubuntu 26.04 görs allmänt tillgänglig, senast 2026.

Varför misslyckas min bygg-pipeline och jag uppmanas att använda autentisering med enkel Sign-On (SSO)?

Byggen kan misslyckas om autentiseringsuppgifterna har upphört att gälla. För att undvika dessa fel rekommenderar vi att du använder NuGet Authenticate-uppgiften för att installera om providern för autentiseringsuppgifter och automatiskt uppdatera autentiseringsuppgifterna. Detta säkerställer oavbruten åtkomst under pipelinekörningen.

steps:
# Authenticate with NuGet to ensure credentials are refreshed
- task: NuGetAuthenticate@1
# Restore NuGet packages
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    restoreSolution: '**/*.sln'
    feedsToUse: 'select'

Examples

Restore

Återställ alla dina lösningar med paket från en vald feed.

# 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'

Package

Skapa ett NuGet-paket i målmappen.

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

Push

Note

Pipelineartefakter laddas ned till katalogen Pipeline.Workspace och till katalogen System.ArtifactsDirectory för klassiska versionspipelines. packagesToPush värde kan anges till $(Pipeline.Workspace)/**/*.nupkg respektive $(System.ArtifactsDirectory)/**/*.nupkg.

  • Skicka/publicera ett paket till en feed som definierats i din NuGet.config.

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

  • Skicka/publicera ett paket till ett flöde med organisationsomfattning

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

  • Skicka/publicera ett paket till ett projektomfångsflöde

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

  • Skicka/publicera ett paket till NuGet.org

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

Custom

Kör alla andra NuGet-kommandon förutom standardkommandona: pack, push och restore.

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

Requirements

Requirement Description
Typer av pipelines YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
Demands None
Capabilities Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Begränsningar för kommandon Any
Inställbara variabler Any
Agentversion 2.144.0 eller senare
Aktivitetskategori Package
Requirement Description
Typer av pipelines YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
Demands None
Capabilities Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Begränsningar för kommandon Any
Inställbara variabler Any
Agentversion 2.115.0 eller senare
Aktivitetskategori Package