Partager via


NuGetCommand@2 - Tâche NuGet v2

Utilisez cette tâche pour restaurer, packer ou envoyer (push) des packages NuGet, ou exécuter une commande NuGet. Cette tâche prend en charge les flux NuGet.org et authentifiés comme Azure Artifacts et MyGet. Cette tâche utilise également NuGet.exe et fonctionne avec les applications .NET Framework. Pour les applications .NET Core et .NET Standard, utilisez la tâche .NET Core.

Syntaxe

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

Entrées

command - commande
string. Obligatoire. Valeurs autorisées : restore, pack, push, custom. Valeur par défaut : restore.

Spécifie la commande NuGet à exécuter. Utilisez la valeur custom pour ajouter des arguments ou pour utiliser une commande différente.


restoreSolution - Chemin d’accès à la solution, packages.configou project.json
Alias d’entrée : solution. string. Obligatoire lorsque command = restore. Valeur par défaut : **/*.sln.

Spécifie le chemin d’accès à la solution, packages.configou project.json fichier qui référence les packages à restaurer.


flux de feedsToUse - à utiliser
Alias d’entrée : selectOrConfig. string. Obligatoire lorsque command = restore. Valeurs autorisées : select (Flux) que je sélectionne ici), config (Flux dans mon NuGet.config). Valeur par défaut : select.

Spécifie un flux à partir d’Azure Artifacts et/ou NuGet.org pour la tâche à utiliser avec la valeur select. Vous pouvez également valider un fichier NuGet.config dans votre référentiel de code source et définir son chemin comme valeur à l’aide de la valeur config.


vstsFeed - Utiliser des packages à partir de ce flux Azure Artifacts/TFS. Sélectionnez dans la liste déroulante ou entrez le nom du flux [nom du projet/].
Alias d’entrée : feedRestore. string. Optionnel. Utilisez quand selectOrConfig = select && command = restore.

Spécifie le flux sélectionné dans le NuGet.configgénéré. La gestion des packages doit être installée et concédée sous licence pour spécifier un flux ici.


vstsFeed - Utiliser des packages à partir de ce flux Azure Artifacts/TFS
Alias d’entrée : feedRestore. string. Optionnel. Utilisez quand selectOrConfig = select && command = restore.

Spécifie le flux sélectionné dans le NuGet.configgénéré. La gestion des packages doit être installée et concédée sous licence pour spécifier un flux ici.


includeNuGetOrg - Utiliser des packages à partir de NuGet.org
boolean. Optionnel. Utilisez quand selectOrConfig = select && command = restore. Valeur par défaut : true.

Inclut NuGet.org dans le NuGet.configgénéré.


chemin d’accès nugetConfigPath - à NuGet.config
string. Optionnel. Utilisez quand selectOrConfig = config && command = restore.

Spécifie le chemin d’accès au NuGet.config dans votre référentiel qui détermine les flux à partir desquels restaurer des packages.


externalFeedCredentials - Credentials for feeds outside this organization/collection
Alias d’entrée : externalEndpoints. string. Optionnel. Utilisez quand selectOrConfig = config && command = restore.

Spécifie les informations d’identification à utiliser pour les registres externes situés dans le NuGet.configsélectionné. Il s’agit du nom de votre connexion de service NuGet. Pour les flux de cette organisation ou de cette collection, laissez ce champ vide ; les informations d’identification de la build sont utilisées automatiquement.


externalFeedCredentials - Credentials for feeds outside this account/collection
Alias d’entrée : externalEndpoints. string. Optionnel. Utilisez quand selectOrConfig = config && command = restore.

Spécifie les informations d’identification à utiliser pour les registres externes situés dans le NuGet.configsélectionné. Il s’agit du nom de votre connexion de service NuGet. Pour les flux de ce compte ou de cette collection, laissez cette valeur vide ; les informations d’identification de la build sont utilisées automatiquement.


noCache - Désactiver les de cache local
boolean. Optionnel. Utilisez quand command = restore. Valeur par défaut : false.

Empêche NuGet d’utiliser des packages à partir de caches d’ordinateurs locaux lorsqu’il est défini sur true.


disableParallelProcessing - Désactiver les de traitement parallèle
boolean. Optionnel. Utilisez quand command = restore. Valeur par défaut : false.

Empêche NuGet d’installer plusieurs packages dans des processus parallèles lorsqu’il est défini sur true.


restoreDirectory - répertoire de destination
Alias d’entrée : packagesDirectory. string. Optionnel. Utilisez quand command = restore.

Spécifie le dossier dans lequel les packages sont installés. Si aucun dossier n’est spécifié, les packages sont restaurés dans un dossier packages/ en même temps que la solution sélectionnée, packages.configou project.json.


verbosityRestore - verbosity
string. Optionnel. Utilisez quand command = restore. Valeurs autorisées : Quiet, Normal, Detailed. Valeur par défaut : Detailed.

Spécifie la quantité de détails affichée dans la sortie.


packagesToPush - Chemin d’accès aux packages NuGet pour publier des
Alias d’entrée : searchPatternPush. string. Obligatoire lorsque command = push. Valeur par défaut : $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.

Spécifie le modèle à mettre en correspondance ou le chemin d’accès à nupkg fichiers à charger. Plusieurs modèles peuvent être séparés par un point-virgule.


emplacement du flux cible nuGetFeedType -
string. Obligatoire lorsque command = push. Valeurs autorisées : internal (cette organisation/collection), external (serveur NuGet externe (y compris d’autres comptes/collections)). Valeur par défaut : internal.

Spécifie si le flux cible est un flux/collection interne ou un serveur NuGet externe.


emplacement du flux cible nuGetFeedType -
string. Obligatoire lorsque command = push. Valeurs autorisées : internal (ce compte/collection), external (serveur NuGet externe (y compris d’autres comptes/collections)). Valeur par défaut : internal.

Spécifie si le flux cible est un flux/collection interne ou un serveur NuGet externe.


publishVstsFeed - de flux cible
Alias d’entrée : feedPublish. string. Obligatoire lorsque command = push && nuGetFeedType = internal.

Spécifie un flux hébergé dans ce compte. Vous devez disposer d’Azure Artifacts installés et concédés sous licence pour sélectionner un flux ici.


publishPackageMetadata - Publier des métadonnées de pipeline
boolean. Optionnel. Utilisez quand command = push && nuGetFeedType = internal. Valeur par défaut : true.

Modifie le numéro de version du sous-ensemble de packages modifiés dans un ensemble de packages publiés en permanence.


allowPackageConflicts - Autoriser les doublons à ignorer
boolean. Optionnel. Utilisez quand command = push && nuGetFeedType = internal. Valeur par défaut : false.

Signale la réussite de la tâche même si certains de vos packages sont rejetés avec des erreurs de conflit 409.

Cette option est actuellement disponible uniquement sur les agents Azure Pipelines et Windows. Si NuGet.exe rencontre un conflit, la tâche échoue. Cette option ne fonctionnera pas et la publication échoue si vous êtes dans un environnement proxy.


publishFeedCredentials - serveur NuGet
Alias d’entrée : externalEndpoint. string. Obligatoire lorsque command = push && nuGetFeedType = external.

Spécifie la connexion de service NuGet qui contient les informations d’identification du serveur NuGet externe.


verbosityPush - verbosity
string. Optionnel. Utilisez quand command = push. Valeurs autorisées : Quiet, Normal, Detailed. Valeur par défaut : Detailed.

Spécifie la quantité de détails affichée dans la sortie.


packagesToPack - Chemin d’accès aux fichiers csproj ou nuspec pour pack
Alias d’entrée : searchPatternPack. string. Obligatoire lorsque command = pack. Valeur par défaut : **/*.csproj.

Spécifie le modèle que la tâche utilise pour rechercher les répertoires csproj à packer.

Vous pouvez séparer plusieurs modèles avec un point-virgule, et vous pouvez créer un modèle négatif en le préfixant avec !. Exemple : **\*.csproj;!**\*.Tests.csproj.


configuration configuration - pour empaqueter
Alias d’entrée : configurationToPack. string. Optionnel. Utilisez quand command = pack. Valeur par défaut : $(BuildConfiguration).

Spécifie la configuration à empaqueter lors de l’utilisation d’un fichier csproj.


packDestination - dossier package
Alias d’entrée : outputDir. string. Optionnel. Utilisez quand command = pack. Valeur par défaut : $(Build.ArtifactStagingDirectory).

Spécifie le dossier dans lequel la tâche crée des packages. Si la valeur est vide, la tâche crée des packages à la racine source.


versioningScheme - de contrôle de version automatique des packages
string. Obligatoire lorsque command = pack. Valeurs autorisées : off, byPrereleaseNumber (Utiliser la date et l’heure), byEnvVar (Utiliser une variable d’environnement), byBuildNumber (Utiliser le numéro de build). Valeur par défaut : off.

Applique le contrôle de version automatique du package en fonction de la valeur spécifiée. Cette chaîne ne peut pas être utilisée avec includeReferencedProjects. Les valeurs autorisées sont les suivantes :

  • byPrereleaseNumber - Utiliser la date et l’heure: la tâche génère une version SemVerconforme au format X.Y.Z-ci-datetime, où vous spécifiez les valeurs de X, Y et Z.
  • byEnvVar - Utiliser une variable d’environnement: la tâche utilise une variable d’environnement que vous spécifiez et contient le numéro de version que vous souhaitez utiliser.
  • byBuildNumber - Utiliser le numéro de build: la tâche utilise le numéro de build pour versionr le package.

Note

Sous Général, définissez le format de build sur $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).


includeReferencedProjects - Inclure des projets référencés
boolean. Optionnel. Utilisez quand versioningScheme = off && command = pack. Valeur par défaut : false.

Inclut des projets référencés en tant que dépendances ou dans le cadre du package. Impossible d’utiliser le contrôle de version automatique du package. Si un projet référencé a un fichier nuspec correspondant qui porte le même nom que le projet, ce projet référencé est ajouté en tant que dépendance. Sinon, le projet référencé est ajouté dans le cadre du package. En savoir plus sur à l’aide de la commande pack pour l’interface CLI NuGet pour créer des packages NuGet.


versionEnvVar - de variable d’environnement
string. Obligatoire lorsque versioningScheme = byEnvVar && command = pack.

Spécifie le nom de la variable sans $, $envou %.


majorVersion - principales
Alias d’entrée : requestedMajorVersion. string. Obligatoire lorsque versioningScheme = byPrereleaseNumber && command = pack. Valeur par défaut : 1.

La X dans la version X.Y.Z.


minorVersion - mineure
Alias d’entrée : requestedMinorVersion. string. Obligatoire lorsque versioningScheme = byPrereleaseNumber && command = pack. Valeur par défaut : 0.

La Y dans la version X.Y.Z.


patchVersion - patch
Alias d’entrée : requestedPatchVersion. string. Obligatoire lorsque versioningScheme = byPrereleaseNumber && command = pack. Valeur par défaut : 0.

La Z dans la version X.Y.Z.


packTimezone - fuseau horaire
string. Optionnel. Utilisez quand versioningScheme = byPrereleaseNumber && command = pack. Valeurs autorisées : utc, local (heure locale de l’agent). Valeur par défaut : utc.

Spécifie le fuseau horaire souhaité utilisé pour produire la version du package. La sélection de utc est recommandée si vous utilisez des agents de build hébergés, car leur date et heure peuvent différer.


includeSymbols - Créer un package de symboles
boolean. Optionnel. Utilisez quand command = pack. Valeur par défaut : false.

Spécifie que le package contient des sources et des symboles. Lorsqu’il est utilisé avec un fichier .nuspec, cela crée un fichier de package NuGet standard et le package de symboles correspondants.


toolPackage - package d’outils
boolean. Optionnel. Utilisez quand command = pack. Valeur par défaut : false.

Détermine si les fichiers de sortie du projet doivent se trouver dans le dossier outil.


buildProperties - propriétés de build supplémentaires
string. Optionnel. Utilisez quand command = pack.

Spécifie une liste de paires token=value, séparées par des points-virgules, où chaque occurrence de $token$ dans le fichier .nuspec sera remplacée par la valeur donnée. Les valeurs peuvent être des chaînes entre guillemets.


basePath - chemin de base
string. Optionnel. Utilisez quand command = pack.

Spécifie le chemin d’accès de base des fichiers définis dans le fichier nuspec.


verbosityPack - verbosity
string. Optionnel. Utilisez quand command = pack. Valeurs autorisées : Quiet, Normal, Detailed. Valeur par défaut : Detailed.

Spécifie la quantité de détails affichée dans la sortie.


arguments - Commandes et arguments
string. Obligatoire lorsque command = custom.

Spécifie la commande et les arguments qui seront passés à NuGet.exe pour l’exécution. Si NuGet 3.5 ou version ultérieure est utilisé, des commandes authentifiées telles que list, restoreet publish par rapport à tout flux de cette organisation ou collection auquel le service de génération de collection de projets a accès sera automatiquement authentifié.


Options de contrôle de tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâche. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Remarques

Important

La tâche l’authentification NuGet est la nouvelle méthode recommandée pour s’authentifier auprès d’Azure Artifacts et d’autres référentiels NuGet. Cette tâche ne prend plus de nouvelles fonctionnalités et seuls les bogues critiques sont résolus.

Utilisez cette tâche pour installer et mettre à jour les dépendances de package NuGet, ou packager et publier des packages NuGet. Utilise NuGet.exe et fonctionne avec les applications .NET Framework. Pour les applications .NET Core et .NET Standard, utilisez la tâche .NET Core.

Si votre code dépend des packages NuGet, veillez à ajouter cette étape avant votre tâche de build Visual Studio. Veillez également à décocher la case à cocher Restaurer les packages NuGet dans cette tâche.

Si vous utilisez .NET Core ou .NET Standard, utilisez la tâche .NET Core, qui prend entièrement en charge tous les scénarios de package et est actuellement prise en charge par dotnet.

Pourboire

Cette version de la tâche NuGet utilise NuGet 4.1.0 par défaut. Pour sélectionner une autre version de NuGet, utilisez le programme d’installation de l’outil .

Schémas de contrôle de version

Pour byPrereleaseNumber, la version est définie sur les valeurs que vous choisissez pour la version principale, la version mineure et le correctif, ainsi que la date et l’heure, au format yyyymmdd-hhmmss.

Pour byEnvVar, la version est définie sur la valeur de la variable d’environnement qui a le nom spécifié par le paramètre versionEnvVar, par exemple MyVersion (pas de $, juste le nom de la variable d’environnement). Vérifiez que la variable d’environnement est définie sur un SemVer approprié, tel que 1.2.3 ou 1.2.3-beta1.

Pour byBuildNumber, la version sera définie à l’aide du numéro de build de l’exécution du pipeline. Il s’agit de la valeur spécifiée pour la propriété name du pipeline, qui est enregistrée dans la variable d’environnement BUILD_BUILDNUMBER). Vérifiez que le numéro de build utilisé contient un SemVer approprié, tel que 1.0.$(Rev:r). Lorsque vous utilisez byBuildNumber, la tâche extrait la version en pointillé, 1.2.3.4, à partir de la chaîne de numéro de build et n’utilise que cette partie. Le reste de la chaîne est supprimé. Si vous souhaitez utiliser le numéro de build tel quel, vous pouvez utiliser byEnvVar comme décrit ci-dessus et définir versionEnvVar sur BUILD_BUILDNUMBER.

Migrer à partir de NuGetInstaller@0 ou de NuGetRestore@1

NuGetInstaller@0 et NuGetRestore@1 sont déconseillés et vous devez les remplacer dans votre pipeline par NuGetCommand@2.

Si vous utilisiez NuGetInstaller@0 avec restoreMode: restore, configurez les entrées suivantes lors de l’utilisation de NuGetCommand@2.

entrée de tâche NuGetCommand@2 Valeur
command restore
restoreSolution Chemin du fichier .sln

Si vous utilisiez NuGetInstaller@0 avec restoreMode: install, configurez les entrées suivantes lors de l’utilisation de NuGetCommand@2.

entrée de tâche NuGetCommand@2 Valeur
command custom
arguments À quoi ressemble la commande d’installation complète dans l’interface CLI NuGet. Par exemple, si vous souhaitez exécuter l’équivalent de nuget install ninject -OutputDirectory c:\proj dans votre pipeline, le paramètre arguments serait install ninject -OutputDirectory c:\proj. Si vous utilisiez le paramètre NuGetInstaller@0nuGetRestoreArgs, ceux-ci vont également dans arguments.

Si vous utilisiez NuGetRestore@1, configurez les entrées suivantes lors de l’utilisation de NuGetCommand@2.

entrée de tâche NuGetCommand@2 Valeur
command restore
restoreSolution Chemin du fichier .sln

Comme pour utiliser NuGetRestore@1 ou l’option NuGetInstaller@0restore, NuGetCommand@2 a des entrées pour définir le flux, choisir entre select ou config, spécifier le chemin d’accès au fichier NuGet.config et utiliser des packages à partir de nuget.org.

Pour plus d’informations, consultez les exemples de suivants.

Prise en charge des images hébergées Ubuntu plus récentes

À compter d’Ubuntu 24.04, les agents hébergés par Microsft ne seront pas fournis avec mono qui est nécessaire pour exécuter le client NuGet sous-jacent qui alimente NuGetCommand@2. Les utilisateurs de cette tâche sur Ubuntu doivent migrer vers la tâche multiplateforme prise en charge à long terme NuGetAuthenticate@1 avec l’interface CLI .NET.

Migration vers l’interface CLI .NET sur Ubuntu

La tâche l’authentification NuGet gère l’injection d’informations d’identification dans les emplacements nécessaires pour que les outils clients s’authentifient en tant qu’identité de pipeline. Consultez la documentation liée pour obtenir des instructions, des faq et des exemples d’utilisation de NuGet Authenticate avec dotnet.

Si commandes dotnet CLI ne prennent pas en charge votre scénario, signalez-le à l’équipe CLI .NET en tant que problème. Vous pouvez continuer à épingler votre image d’agent à Ubuntu 22.04 ou version antérieure. La prise en charge d’Ubuntu 22.04 continuera jusqu’à ce que Ubuntu 26.04 soit mis à la disposition générale, pas plus tôt que 2026.

Exemples

Restaurer

Restaurez toutes vos solutions avec des packages à partir d’un flux sélectionné.

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

Colis

Créez un package NuGet dans le dossier de destination.

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

Pousser

Note

Les artefacts de pipeline sont téléchargés dans le répertoire Pipeline.Workspace et dans le répertoire System.ArtifactsDirectory pour les pipelines de mise en production classiques. packagesToPush valeur peut être définie sur $(Pipeline.Workspace)/**/*.nupkg ou $(System.ArtifactsDirectory)/**/*.nupkg respectivement.

  • Envoyez/publiez un package vers un flux défini dans votre NuGet.config.

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg'
        feedsToUse: 'config'
        nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
    
  • Envoyer (push)/publier un package dans un flux délimité par l’organisation

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-organization-scoped-feed'
    
  • Envoyer (push)/publier un package vers un flux délimité par un projet

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-project/my-project-scoped-feed'
    
  • Envoyer/publier un package sur NuGet.org

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

Coutume

Exécutez toute autre commande NuGet en plus des commandes par défaut : pack, push et restauration.

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

Exigences

Exigence Description
Types de pipelines YAML, Build Classique, Version Classique
Exécutions sur Agent, DeploymentGroup
demandes Aucun
fonctionnalités de Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande Quelconque
variables settables Quelconque
Version de l’agent 2.144.0 ou version ultérieure
Catégorie de tâche Colis
Exigence Description
Types de pipelines YAML, Build Classique, Version Classique
Exécutions sur Agent, DeploymentGroup
demandes Aucun
fonctionnalités de Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande Quelconque
variables settables Quelconque
Version de l’agent 2.115.0 ou version ultérieure
Catégorie de tâche Colis