NuGetCommand@2 - NuGet v2-taak
Gebruik deze taak om NuGet-pakketten te herstellen, inpakken of pushen of een NuGet-opdracht uit te voeren. Deze taak ondersteunt NuGet.org en geverifieerde feeds, zoals Azure Artifacts en MyGet. Deze taak maakt ook gebruik van NuGet.exe en werkt met .NET Framework-apps. Gebruik voor .NET Core- en .NET Standard-apps de .NET Core-taak.
Syntaxis
# 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.
# NuGet v2
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Package Management 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 account/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
#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.
Ingangen
command
-
opdracht
string
. Vereist. Toegestane waarden: restore
, pack
, push
, custom
. Standaardwaarde: restore
.
Hiermee geeft u de NuGet-opdracht die moet worden uitgevoerd. Gebruik de custom
-waarde om argumenten toe te voegen of een andere opdracht te gebruiken.
restoreSolution
-
pad naar oplossing, packages.configof project.json
Invoeralias: solution
.
string
. Vereist wanneer command = restore
. Standaardwaarde: **/*.sln
.
Hiermee geeft u het pad naar de oplossing, packages.config
of project.json
bestand dat verwijst naar de pakketten die moeten worden hersteld.
feedsToUse
-
feeds om te gebruiken
Invoeralias: selectOrConfig
.
string
. Vereist wanneer command = restore
. Toegestane waarden: select
(feed(s) die ik hier selecteer), config
(Feeds in mijn NuGet.config). Standaardwaarde: select
.
Hiermee geeft u een feed van Azure Artifacts en/of NuGet.org voor de taak te gebruiken met de select
waarde. U kunt ook een NuGet.config
bestand doorvoeren in uw opslagplaats voor broncode en het pad instellen als de waarde met behulp van de config
waarde.
vstsFeed
-
Pakketten uit deze Azure Artifacts/TFS-feed gebruiken. Selecteer in de vervolgkeuzelijst of voer [projectnaam/]feednaam in.
Invoeralias: feedRestore
.
string
. Facultatief. Gebruiken wanneer selectOrConfig = select && command = restore
.
Hiermee geeft u de geselecteerde feed in de gegenereerde NuGet.config
. U moet Pakketbeheer hebben geïnstalleerd en een licentie hebben om hier een feed op te geven.
vstsFeed
-
Pakketten uit deze Azure Artifacts-/TFS-feed gebruiken
Invoeralias: feedRestore
.
string
. Facultatief. Gebruiken wanneer selectOrConfig = select && command = restore
.
Hiermee geeft u de geselecteerde feed in de gegenereerde NuGet.config
. U moet Pakketbeheer hebben geïnstalleerd en een licentie hebben om hier een feed op te geven.
includeNuGetOrg
-
Pakketten uit NuGet.org gebruiken
boolean
. Facultatief. Gebruiken wanneer selectOrConfig = select && command = restore
. Standaardwaarde: true
.
Bevat NuGet.org in de gegenereerde NuGet.config
.
nugetConfigPath
-
pad naar NuGet.config
string
. Facultatief. Gebruiken wanneer selectOrConfig = config && command = restore
.
Hiermee geeft u het pad naar de NuGet.config
in uw opslagplaats die bepaalt van welke feeds pakketten moeten worden hersteld.
externalFeedCredentials
-
referenties voor feeds buiten deze organisatie/verzameling
Invoeralias: externalEndpoints
.
string
. Facultatief. Gebruiken wanneer selectOrConfig = config && command = restore
.
Hiermee geeft u de referenties op die moeten worden gebruikt voor externe registers die zich in de geselecteerde NuGet.config
bevinden. Dit is de naam van uw NuGet-serviceverbinding. Laat dit leeg voor feeds in deze organisatie of verzameling; de referenties van de build worden automatisch gebruikt.
externalFeedCredentials
-
referenties voor feeds buiten dit account/verzameling
Invoeralias: externalEndpoints
.
string
. Facultatief. Gebruiken wanneer selectOrConfig = config && command = restore
.
Hiermee geeft u de referenties op die moeten worden gebruikt voor externe registers die zich in de geselecteerde NuGet.config
bevinden. Dit is de naam van uw NuGet-serviceverbinding. Laat dit leeg voor feeds in dit account of deze verzameling; de referenties van de build worden automatisch gebruikt.
noCache
-
lokale cache uitschakelen
boolean
. Facultatief. Gebruiken wanneer command = restore
. Standaardwaarde: false
.
Hiermee voorkomt u dat NuGet pakketten van lokale computercaches gebruikt wanneer deze is ingesteld op true
.
disableParallelProcessing
-
parallelle verwerking uitschakelen
boolean
. Facultatief. Gebruiken wanneer command = restore
. Standaardwaarde: false
.
Hiermee voorkomt u dat NuGet meerdere pakketten in parallelle processen installeert wanneer deze is ingesteld op true
.
restoreDirectory
-
doelmap
Invoeralias: packagesDirectory
.
string
. Facultatief. Gebruiken wanneer command = restore
.
Hiermee geeft u de map waarin pakketten worden geïnstalleerd. Als er geen map is opgegeven, worden pakketten hersteld in een packages/
map naast de geselecteerde oplossing, packages.config
of project.json
.
verbosityRestore
-
uitgebreidheids-
string
. Facultatief. Gebruiken wanneer command = restore
. Toegestane waarden: Quiet
, Normal
, Detailed
. Standaardwaarde: Detailed
.
Hiermee geeft u de hoeveelheid details op die in de uitvoer wordt weergegeven.
packagesToPush
-
Pad naar NuGet-pakketten om te publiceren
Invoeralias: searchPatternPush
.
string
. Vereist wanneer command = push
. Standaardwaarde: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg
.
Hiermee geeft u het patroon dat overeenkomt met of het pad naar nupkg
bestanden die moeten worden geüpload. Meerdere patronen kunnen worden gescheiden door een puntkomma.
nuGetFeedType
-
locatie van doelfeed
string
. Vereist wanneer command = push
. Toegestane waarden: internal
(deze organisatie/verzameling), external
(externe NuGet-server (inclusief andere accounts/verzamelingen)). Standaardwaarde: internal
.
Hiermee geeft u op of de doelfeed een interne feed/verzameling of een externe NuGet-server is.
nuGetFeedType
-
locatie van doelfeed
string
. Vereist wanneer command = push
. Toegestane waarden: internal
(dit account/verzameling), external
(externe NuGet-server (inclusief andere accounts/verzamelingen)). Standaardwaarde: internal
.
Hiermee geeft u op of de doelfeed een interne feed/verzameling of een externe NuGet-server is.
publishVstsFeed
-
doelfeed
Invoeralias: feedPublish
.
string
. Vereist wanneer command = push && nuGetFeedType = internal
.
Hiermee geeft u een feed op die wordt gehost in dit account. U moet Azure Artifacts hebben geïnstalleerd en een licentie hebben om hier een feed te selecteren.
publishPackageMetadata
-
metagegevens van pijplijn publiceren
boolean
. Facultatief. Gebruiken wanneer command = push && nuGetFeedType = internal
. Standaardwaarde: true
.
Hiermee wijzigt u het versienummer van de subset van gewijzigde pakketten binnen een set voortdurend gepubliceerde pakketten.
allowPackageConflicts
-
Toestaan dat duplicaten worden overgeslagen
boolean
. Facultatief. Gebruiken wanneer command = push && nuGetFeedType = internal
. Standaardwaarde: false
.
Rapporteert het slagen van taken, zelfs als sommige van uw pakketten worden geweigerd met 409 conflictfouten.
Deze optie is momenteel alleen beschikbaar in Azure Pipelines en Windows-agents. Als NuGet.exe
een conflict ondervindt, mislukt de taak. Deze optie werkt niet en publiceren mislukt als u zich in een proxyomgeving bevindt.
publishFeedCredentials
-
NuGet-server
Invoeralias: externalEndpoint
.
string
. Vereist wanneer command = push && nuGetFeedType = external
.
Hiermee geeft u de NuGet-serviceverbinding op die de referenties van de externe NuGet-server bevat.
verbosityPush
-
uitgebreidheids-
string
. Facultatief. Gebruiken wanneer command = push
. Toegestane waarden: Quiet
, Normal
, Detailed
. Standaardwaarde: Detailed
.
Hiermee geeft u de hoeveelheid details op die in de uitvoer wordt weergegeven.
packagesToPack
-
pad naar csproj- of nuspec-bestanden om in te pakken
Invoeralias: searchPatternPack
.
string
. Vereist wanneer command = pack
. Standaardwaarde: **/*.csproj
.
Hiermee geeft u het patroon op dat de taak gebruikt om te zoeken naar csproj-mappen die moeten worden verpakt.
U kunt meerdere patronen scheiden met een puntkomma en u kunt een patroon negatief maken door het voorvoegsel te voorzien van !
. Voorbeeld: **\*.csproj;!**\*.Tests.csproj
.
configuration
-
configureren om te verpakken
Invoeralias: configurationToPack
.
string
. Facultatief. Gebruiken wanneer command = pack
. Standaardwaarde: $(BuildConfiguration)
.
Hiermee geeft u de configuratie die moet worden verpakt wanneer u een csproj-bestand gebruikt.
packDestination
-
pakketmap
Invoeralias: outputDir
.
string
. Facultatief. Gebruiken wanneer command = pack
. Standaardwaarde: $(Build.ArtifactStagingDirectory)
.
Hiermee geeft u de map waarin de taak pakketten maakt. Als de waarde leeg is, maakt de taak pakketten in de bronhoofdmap.
versioningScheme
-
automatische pakketversiebeheer
string
. Vereist wanneer command = pack
. Toegestane waarden: off
, byPrereleaseNumber
(De datum en tijd gebruiken), byEnvVar
(Een omgevingsvariabele gebruiken), byBuildNumber
(het buildnummer gebruiken). Standaardwaarde: off
.
Past automatische pakketversiebeheer toe, afhankelijk van de opgegeven waarde. Deze tekenreeks kan niet worden gebruikt met includeReferencedProjects
. De toegestane waarden zijn:
-
byPrereleaseNumber
- De datum- en tijd-gebruiken: de taak genereert een SemVer-compatibele versie die is opgemaakt alsX.Y.Z-ci-datetime
, waarbij u de waarden van X, Y en Z opgeeft. -
byEnvVar
- Een omgevingsvariabele gebruiken: de taak gebruikt een omgevingsvariabele die u opgeeft en bevat het versienummer dat u wilt gebruiken. -
byBuildNumber
- Gebruik het buildnummer: de taak gebruikt het buildnummer om het pakket te versien.
Notitie
Stel onder Algemeen de build-indeling in op $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)
.
includeReferencedProjects
-
Projecten waarnaar wordt verwezen, opnemen
boolean
. Facultatief. Gebruiken wanneer versioningScheme = off && command = pack
. Standaardwaarde: false
.
Bevat projecten waarnaar wordt verwezen als afhankelijkheden of als onderdeel van het pakket. Kan niet worden gebruikt met automatische pakketversiebeheer. Als een project waarnaar wordt verwezen een overeenkomend nuspec
-bestand met dezelfde naam heeft als het project, wordt dat project als een afhankelijkheid toegevoegd. Anders wordt het project waarnaar wordt verwezen toegevoegd als onderdeel van het pakket. Meer informatie over met behulp van de packopdracht voor NuGet CLI voor het maken van NuGet-pakketten.
versionEnvVar
-
omgevingsvariabele
string
. Vereist wanneer versioningScheme = byEnvVar && command = pack
.
Hiermee geeft u de naam van de variabele zonder $
, $env
of %
.
majorVersion
-
primaire
Invoeralias: requestedMajorVersion
.
string
. Vereist wanneer versioningScheme = byPrereleaseNumber && command = pack
. Standaardwaarde: 1
.
De X
in versie X.Y.Z.
minorVersion
-
secundaire
Invoeralias: requestedMinorVersion
.
string
. Vereist wanneer versioningScheme = byPrereleaseNumber && command = pack
. Standaardwaarde: 0
.
De Y
in versie X.Y.Z.
patchVersion
-
Patch-
Invoeralias: requestedPatchVersion
.
string
. Vereist wanneer versioningScheme = byPrereleaseNumber && command = pack
. Standaardwaarde: 0
.
De Z
in versie X.Y.Z.
packTimezone
-
tijdzone
string
. Facultatief. Gebruiken wanneer versioningScheme = byPrereleaseNumber && command = pack
. Toegestane waarden: utc
, local
(lokale tijd van agent). Standaardwaarde: utc
.
Hiermee geeft u de gewenste tijdzone op die wordt gebruikt om de versie van het pakket te produceren. Het selecteren van utc
wordt aanbevolen als u gehoste buildagents gebruikt, omdat de datum en tijd kunnen verschillen.
includeSymbols
-
symbolenpakket maken
boolean
. Facultatief. Gebruiken wanneer command = pack
. Standaardwaarde: false
.
Hiermee geeft u op dat het pakket bronnen en symbolen bevat. Bij gebruik met een .nuspec
-bestand wordt hiermee een gewoon NuGet-pakketbestand en het bijbehorende symbolenpakket gemaakt.
toolPackage
-
Tool Package
boolean
. Facultatief. Gebruiken wanneer command = pack
. Standaardwaarde: false
.
Bepaalt of de uitvoerbestanden van het project zich in de map met hulpprogramma's moeten bevinden.
buildProperties
-
Aanvullende buildeigenschappen
string
. Facultatief. Gebruiken wanneer command = pack
.
Hiermee geeft u een lijst met token=waardeparen op, gescheiden door puntkomma's, waarbij elk exemplaar van $token$
in het .nuspec
bestand wordt vervangen door de opgegeven waarde. Waarden kunnen tekenreeksen tussen aanhalingstekens zijn.
basePath
-
basispad
string
. Facultatief. Gebruiken wanneer command = pack
.
Hiermee geeft u het basispad op van de bestanden die zijn gedefinieerd in het nuspec
-bestand.
verbosityPack
-
uitgebreidheids-
string
. Facultatief. Gebruiken wanneer command = pack
. Toegestane waarden: Quiet
, Normal
, Detailed
. Standaardwaarde: Detailed
.
Hiermee geeft u de hoeveelheid details op die in de uitvoer wordt weergegeven.
arguments
-
opdracht en argumenten
string
. Vereist wanneer command = custom
.
Hiermee geeft u de opdracht en argumenten die worden doorgegeven aan NuGet.exe
voor uitvoering. Als NuGet 3.5 of hoger wordt gebruikt, worden geverifieerde opdrachten zoals list
, restore
en publish
op elke feed in deze organisatie of verzameling waartoe de Project Collection Build Service toegang heeft, automatisch geverifieerd.
Opties voor taakbeheer
Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.
Uitvoervariabelen
Geen.
Opmerkingen
Belangrijk
De NuGet-verificatie taak is de nieuwe aanbevolen manier om te verifiëren met Azure Artifacts en andere NuGet-opslagplaatsen. Deze taak neemt geen nieuwe functies meer in beslag en er worden alleen kritieke fouten opgelost.
Gebruik deze taak om NuGet-pakketafhankelijkheden te installeren en bij te werken, of om NuGet-pakketten te verpakken en te publiceren. Gebruikt NuGet.exe en werkt met .NET Framework-apps. Gebruik voor .NET Core- en .NET Standard-apps de .NET Core-taak.
Als uw code afhankelijk is van NuGet-pakketten, moet u deze stap toevoegen voordat uw Visual Studio Build-taak. Zorg er ook voor dat u het afgeschafte selectievakje NuGet-pakketten herstellen selectievakje in die taak wist.
Als u met .NET Core of .NET Standard werkt, gebruikt u de taak .NET Core, die volledige ondersteuning biedt voor alle pakketscenario's en momenteel wordt ondersteund door dotnet.
Fooi
Deze versie van de NuGet-taak maakt standaard gebruik van NuGet 4.1.0. Als u een andere versie van NuGet wilt selecteren, gebruikt u de Tool Installer-.
Versiebeheerschema's
Voor byPrereleaseNumberwordt de versie ingesteld op de waarden die u kiest voor de primaire versie, de secundaire versie en de patch, plus de datum en tijd, in de indeling yyyymmdd-hhmmss
.
Voor byEnvVarwordt de versie ingesteld op de waarde van de omgevingsvariabele met de naam die is opgegeven door de parameter versionEnvVar, bijvoorbeeld MyVersion
(geen $, alleen de naam van de omgevingsvariabele). Zorg ervoor dat de omgevingsvariabele is ingesteld op een juiste SemVer, zoals 1.2.3
of 1.2.3-beta1
.
Voor byBuildNumberwordt de versie ingesteld met behulp van het buildnummer van de pijplijnuitvoering. Dit is de waarde die is opgegeven voor de eigenschap name
van de pijplijn, die wordt opgeslagen in de omgevingsvariabele BUILD_BUILDNUMBER
). Zorg ervoor dat het gebruikte buildnummer een juiste SemVer bevat, zoals 1.0.$(Rev:r)
. Wanneer u byBuildNumbergebruikt, wordt de gestippelde versie, 1.2.3.4
, uit de buildnummertekenreeks geëxtraheerd en wordt alleen dat gedeelte gebruikt. De rest van de tekenreeks wordt verwijderd. Als u het buildnummer als zodanig wilt gebruiken, kunt u byEnvVar zoals hierboven beschreven, gebruiken en versionEnvVar instellen op BUILD_BUILDNUMBER
.
Migreren van NuGetInstaller@0 of NuGetRestore@1
NuGetInstaller@0
en NuGetRestore@1
zijn afgeschaft en moet u deze in uw pijplijn vervangen door NuGetCommand@2
.
Als u NuGetInstaller@0
gebruikt met restoreMode: restore
, configureert u de volgende invoer wanneer u NuGetCommand@2
gebruikt.
NuGetCommand@2 taakinvoer | Waarde |
---|---|
command |
restore |
restoreSolution |
Pad naar het .sln-bestand |
Als u NuGetInstaller@0
gebruikt met restoreMode: install
, configureert u de volgende invoer wanneer u NuGetCommand@2
gebruikt.
NuGetCommand@2 taakinvoer | Waarde |
---|---|
command |
custom |
arguments |
Hoe de volledige installatieopdracht eruit zou zien in de NuGet CLI. Als u bijvoorbeeld het equivalent van nuget install ninject -OutputDirectory c:\proj in uw pijplijn wilt uitvoeren, wordt de parameter arguments install ninject -OutputDirectory c:\proj . Als u de parameter NuGetInstaller@0 nuGetRestoreArgs gebruikt, gaan deze nu ook in arguments . |
Als u NuGetRestore@1
gebruikt, configureert u de volgende invoer wanneer u NuGetCommand@2
gebruikt.
NuGetCommand@2 taakinvoer | Waarde |
---|---|
command |
restore |
restoreSolution |
Pad naar het .sln-bestand |
Net als bij het gebruik van NuGetRestore@1
of de optie NuGetInstaller@0
restore
, heeft NuGetCommand@2
invoer om de feed in te stellen, te kiezen tussen select
of config
, het pad naar het NuGet.config
bestand op te geven en pakketten uit nuget.org te gebruiken.
Zie de volgende voorbeeldenvoor meer informatie.
Ondersteuning voor nieuwere gehoste Ubuntu-installatiekopieën
Vanaf Ubuntu 24.04 worden door Microsft gehoste agents niet verzonden met mono- die nodig is om de onderliggende NuGet-client uit te voeren die NuGetCommand@2
aangeeft. Gebruikers van deze taak op Ubuntu moeten migreren naar de langlopende ondersteunde platformoverschrijdende taak NuGetAuthenticate@1
met .NET CLI.
Migreren naar .NET CLI in Ubuntu
De NuGet-verificatietaak taak verwerkt het injecteren van referenties op de benodigde plaatsen voor clienthulpprogramma's om te verifiëren als uw pijplijnidentiteit. Raadpleeg de gekoppelde documentatie voor instructies, veelgestelde vragen en voorbeelden voor het gebruik van NuGet Authenticate
met dotnet.
Als dotnet CLI-opdrachten uw scenario niet ondersteunen, dit melden aan het .NET CLI-team als een probleem. U kunt uw agentinstallatiekopie blijven vastmaken aan Ubuntu 22.04 of eerder. Ondersteuning voor Ubuntu 22.04 wordt voortgezet totdat Ubuntu 26.04 algemeen beschikbaar wordt gesteld, niet eerder dan 2026.
Voorbeelden
Herstellen
Herstel al uw oplossingen met pakketten uit een geselecteerde 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'
Pak
Maak een NuGet-pakket in de doelmap.
# Package a project
- task: NuGetCommand@2
inputs:
command: 'pack'
packagesToPack: '**/*.csproj'
packDestination: '$(Build.ArtifactStagingDirectory)'
Duwen
Notitie
Pijplijnartefacten worden gedownload naar de Pipeline.Workspace
map en naar de System.ArtifactsDirectory
map voor klassieke release-pijplijnen.
packagesToPush
waarde kan worden ingesteld op respectievelijk $(Pipeline.Workspace)/**/*.nupkg
of $(System.ArtifactsDirectory)/**/*.nupkg
.
Push/Publiceer een pakket naar een feed die is gedefinieerd in uw NuGet.config.
# Push a project - task: NuGetCommand@2 inputs: command: 'push' packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg' feedsToUse: 'config' nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
Een pakket pushen/publiceren naar een binnen de organisatie scoped feed
# Push a project - task: NuGetCommand@2 inputs: command: 'push' nuGetFeedType: 'internal' publishVstsFeed: 'my-organization-scoped-feed'
Een pakket pushen/publiceren naar een projectbereikfeed
# Push a project - task: NuGetCommand@2 inputs: command: 'push' nuGetFeedType: 'internal' publishVstsFeed: 'my-project/my-project-scoped-feed'
Een pakket pushen/publiceren naar NuGet.org
# Push a project - task: NuGetCommand@2 inputs: command: 'push' feedsToUse: 'config' includeNugetOrg: 'true'
Gewoonte
Voer een andere NuGet-opdracht uit naast de standaardopdrachten: inpakken, pushen en herstellen.
# list local NuGet resources.
- task: NuGetCommand@2
displayName: 'list locals'
inputs:
command: custom
arguments: 'locals all -list'
Eisen
Eis | Beschrijving |
---|---|
Pijplijntypen | YAML, klassieke build, klassieke release |
Wordt uitgevoerd op | Agent, DeploymentGroup |
eisen | Geen |
mogelijkheden | Deze taak voldoet niet aan de vereisten voor volgende taken in de taak. |
opdrachtbeperkingen | Enig |
variabelen instellen | Enig |
Agentversie | 2.144.0 of hoger |
Taakcategorie | Pak |
Eis | Beschrijving |
---|---|
Pijplijntypen | YAML, klassieke build, klassieke release |
Wordt uitgevoerd op | Agent, DeploymentGroup |
eisen | Geen |
mogelijkheden | Deze taak voldoet niet aan de vereisten voor volgende taken in de taak. |
opdrachtbeperkingen | Enig |
variabelen instellen | Enig |
Agentversie | 2.115.0 of hoger |
Taakcategorie | Pak |