Condividi tramite


NuGetCommand@2 - Attività NuGet v2

Usare questa attività per ripristinare, comprimere o eseguire il push di pacchetti NuGet oppure eseguire un comando NuGet. Questa attività supporta NuGet.org e feed autenticati come Azure Artifacts e MyGet. Questa attività usa anche NuGet.exe e funziona con le app .NET Framework. Per le app .NET Core e .NET Standard, usare l'attività .NET Core.

Sintassi

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

Ingressi

command - comando
string. Obbligatorio. Valori consentiti: restore, pack, push, custom. Valore predefinito: restore.

Specifica il comando NuGet da eseguire. Usare il valore custom per aggiungere argomenti o per usare un comando diverso.


restoreSolution - Percorso di soluzione, packages.configo project.json
Alias di input: solution. string. Obbligatorio quando command = restore. Valore predefinito: **/*.sln.

Specifica il percorso della soluzione, packages.configo project.json file che fa riferimento ai pacchetti da ripristinare.


feed feedsToUse - da usare
Alias di input: selectOrConfig. string. Obbligatorio quando command = restore. Valori consentiti: select (feed selezionati qui), config (feed nel NuGet.config). Valore predefinito: select.

Specifica un feed di Azure Artifacts e/o NuGet.org per l'attività da usare con il valore select. In alternativa, è possibile eseguire il commit di un file NuGet.config nel repository del codice sorgente e impostarne il percorso come valore usando il valore config.


vstsFeed - Usare pacchetti da questo feed Azure Artifacts/TFS. Selezionare dall'elenco a discesa o immettere [nome progetto/]nome feed.
Alias di input: feedRestore. string. Opzionale. Usare quando selectOrConfig = select && command = restore.

Specifica il feed selezionato nel NuGet.configgenerato. Per specificare un feed, è necessario che Gestione pacchetti sia installato e concesso in licenza.


vstsFeed - Usare pacchetti di questo feed di Azure Artifacts/TFS
Alias di input: feedRestore. string. Opzionale. Usare quando selectOrConfig = select && command = restore.

Specifica il feed selezionato nel NuGet.configgenerato. Per specificare un feed, è necessario che Gestione pacchetti sia installato e concesso in licenza.


includeNuGetOrg - Usare pacchetti da NuGet.org
boolean. Opzionale. Usare quando selectOrConfig = select && command = restore. Valore predefinito: true.

Include NuGet.org nel NuGet.configgenerato.


nugetConfigPath - Percorso di NuGet.config
string. Opzionale. Usare quando selectOrConfig = config && command = restore.

Specifica il percorso del NuGet.config nel repository che determina i feed da cui ripristinare i pacchetti.


externalFeedCredentials - Credenziali per i feed esterni a questa organizzazione/raccolta
Alias di input: externalEndpoints. string. Opzionale. Usare quando selectOrConfig = config && command = restore.

Specifica le credenziali da usare per i registri esterni che si trovano nel NuGet.configselezionato. Si tratta del nome della connessione al servizio NuGet. Per i feed in questa organizzazione o raccolta, lasciare vuoto questo campo; le credenziali della compilazione vengono usate automaticamente.


externalFeedCredentials - Credenziali per i feed esterni a questo account/raccolta
Alias di input: externalEndpoints. string. Opzionale. Usare quando selectOrConfig = config && command = restore.

Specifica le credenziali da usare per i registri esterni che si trovano nel NuGet.configselezionato. Si tratta del nome della connessione al servizio NuGet. Per i feed in questo account o raccolta, lasciare vuoto questo; le credenziali della compilazione vengono usate automaticamente.


noCache - Disabilitare la cache locale
boolean. Opzionale. Usare quando command = restore. Valore predefinito: false.

Impedisce a NuGet di usare pacchetti dalla cache del computer locale quando è impostato su true.


disableParallelProcessing - Disabilitare l'elaborazione parallela
boolean. Opzionale. Usare quando command = restore. Valore predefinito: false.

Impedisce a NuGet di installare più pacchetti in processi paralleli quando è impostato su true.


restoreDirectory - directory di destinazione
Alias di input: packagesDirectory. string. Opzionale. Usare quando command = restore.

Specifica la cartella in cui vengono installati i pacchetti. Se non viene specificata alcuna cartella, i pacchetti vengono ripristinati in una cartella packages/ insieme alla soluzione selezionata, packages.configo project.json.


verbosityRestore - dettagliato
string. Opzionale. Usare quando command = restore. Valori consentiti: Quiet, Normal, Detailed. Valore predefinito: Detailed.

Specifica la quantità di dettagli visualizzati nell'output.


packagesToPush - percorso dei pacchetti NuGet da pubblicare
Alias di input: searchPatternPush. string. Obbligatorio quando command = push. Valore predefinito: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.

Specifica il modello di corrispondenza o il percorso per nupkg file da caricare. Più modelli possono essere separati da un punto e virgola.


nuGetFeedType - percorso feed di destinazione
string. Obbligatorio quando command = push. Valori consentiti: internal (questa organizzazione/raccolta), external (server NuGet esterno (inclusi altri account/raccolte)). Valore predefinito: internal.

Specifica se il feed di destinazione è un feed/raccolta interno o un server NuGet esterno.


nuGetFeedType - percorso feed di destinazione
string. Obbligatorio quando command = push. Valori consentiti: internal (questo account/raccolta), external (server NuGet esterno (inclusi altri account/raccolte)). Valore predefinito: internal.

Specifica se il feed di destinazione è un feed/raccolta interno o un server NuGet esterno.


publishVstsFeed - feed di destinazione
Alias di input: feedPublish. string. Obbligatorio quando command = push && nuGetFeedType = internal.

Specifica un feed ospitato in questo account. Per selezionare un feed, è necessario che Azure Artifacts sia installato e concesso in licenza.


publishPackageMetadata - Pubblicare i metadati della pipeline
boolean. Opzionale. Usare quando command = push && nuGetFeedType = internal. Valore predefinito: true.

Modifica il numero di versione del subset di pacchetti modificati all'interno di un set di pacchetti continuamente pubblicati.


allowPackageConflicts - Consente di ignorare i duplicati
boolean. Opzionale. Usare quando command = push && nuGetFeedType = internal. Valore predefinito: false.

Segnala l'esito positivo dell'attività anche se alcuni pacchetti vengono rifiutati con errori di conflitto 409.

Questa opzione è attualmente disponibile solo in Azure Pipelines e agenti Windows. Se NuGet.exe si verifica un conflitto, l'attività avrà esito negativo. Questa opzione non funzionerà e la pubblicazione avrà esito negativo se si è all'interno di un ambiente proxy.


publishFeedCredentials - server NuGet
Alias di input: externalEndpoint. string. Obbligatorio quando command = push && nuGetFeedType = external.

Specifica la connessione al servizio NuGet che contiene le credenziali del server NuGet esterno.


verbosityPush - dettagliato
string. Opzionale. Usare quando command = push. Valori consentiti: Quiet, Normal, Detailed. Valore predefinito: Detailed.

Specifica la quantità di dettagli visualizzati nell'output.


packagesToPack - percorso di file csproj o nuspec da comprimere
Alias di input: searchPatternPack. string. Obbligatorio quando command = pack. Valore predefinito: **/*.csproj.

Specifica il modello utilizzato dall'attività per cercare le directory csproj da comprimere.

È possibile separare più modelli con un punto e virgola ed è possibile rendere un criterio negativo anteponendolo a !. Esempio: **\*.csproj;!**\*.Tests.csproj.


configurazione di configuration - per creare un pacchetto
Alias di input: configurationToPack. string. Opzionale. Usare quando command = pack. Valore predefinito: $(BuildConfiguration).

Specifica la configurazione da creare in pacchetto quando si usa un file csproj.


packDestination - cartella package
Alias di input: outputDir. string. Opzionale. Usare quando command = pack. Valore predefinito: $(Build.ArtifactStagingDirectory).

Specifica la cartella in cui l'attività crea pacchetti. Se il valore è vuoto, l'attività crea pacchetti nella radice di origine.


versioningScheme - controllo automatico delle versioni dei pacchetti
string. Obbligatorio quando command = pack. Valori consentiti: off, byPrereleaseNumber (usare la data e l'ora), byEnvVar (usare una variabile di ambiente), byBuildNumber (usare il numero di build). Valore predefinito: off.

Applica il controllo delle versioni automatiche dei pacchetti a seconda del valore specificato. Questa stringa non può essere usata con includeReferencedProjects. I valori consentiti sono:

  • byPrereleaseNumber - Usare la data e l'ora: l'attività genererà una versione conforme SemVerformattata come X.Y.Z-ci-datetime, dove si specificano i valori di X, Y e Z.
  • byEnvVar - Usare una variabile di ambiente: l'attività userà una variabile di ambiente specificata e contiene il numero di versione da usare.
  • byBuildNumber - Usare il numero di build: l'attività userà il numero di build per la versione del pacchetto.

Nota

In Generale impostare il formato di compilazione da $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).


includeReferencedProjects - Includere progetti a cui si fa riferimento
boolean. Opzionale. Usare quando versioningScheme = off && command = pack. Valore predefinito: false.

Include progetti a cui si fa riferimento come dipendenze o come parte del pacchetto. Non può essere usato con il controllo automatico delle versioni dei pacchetti. Se un progetto a cui si fa riferimento ha un file di nuspec corrispondente con lo stesso nome del progetto, tale progetto a cui si fa riferimento viene aggiunto come dipendenza. In caso contrario, il progetto a cui si fa riferimento viene aggiunto come parte del pacchetto. Altre informazioni sulle usando il comando pack per l'interfaccia della riga di comando di NuGet per creare pacchetti NuGet.


versionEnvVar - Variabile di ambiente
string. Obbligatorio quando versioningScheme = byEnvVar && command = pack.

Specifica il nome della variabile senza $, $envo %.


majorVersion - principali
Alias di input: requestedMajorVersion. string. Obbligatorio quando versioningScheme = byPrereleaseNumber && command = pack. Valore predefinito: 1.

Il X nella versione X.Y.Z.


minorVersion - secondaria
Alias di input: requestedMinorVersion. string. Obbligatorio quando versioningScheme = byPrereleaseNumber && command = pack. Valore predefinito: 0.

Il Y nella versione X.Y.Z.


patchVersion - patch
Alias di input: requestedPatchVersion. string. Obbligatorio quando versioningScheme = byPrereleaseNumber && command = pack. Valore predefinito: 0.

Il Z nella versione X.Y.Z.


packTimezone - fuso orario
string. Opzionale. Usare quando versioningScheme = byPrereleaseNumber && command = pack. Valori consentiti: utc, local (ora locale dell'agente). Valore predefinito: utc.

Specifica il fuso orario desiderato utilizzato per produrre la versione del pacchetto. È consigliabile selezionare utc se si usano agenti di compilazione ospitati, in quanto la data e l'ora potrebbero variare.


includeSymbols - Creare un pacchetto di simboli
boolean. Opzionale. Usare quando command = pack. Valore predefinito: false.

Specifica che il pacchetto contiene origini e simboli. Se usato con un file .nuspec, viene creato un normale file di pacchetto NuGet e il pacchetto dei simboli corrispondente.


pacchetto dello strumento di toolPackage -
boolean. Opzionale. Usare quando command = pack. Valore predefinito: false.

Determina se i file di output del progetto devono trovarsi nella cartella degli strumenti.


buildProperties - proprietà di compilazione aggiuntive
string. Opzionale. Usare quando command = pack.

Specifica un elenco di coppie token=valore, separate da punti e virgola, in cui ogni occorrenza di $token$ nel file .nuspec verrà sostituita con il valore specificato. I valori possono essere stringhe tra virgolette.


basePath - percorso di base
string. Opzionale. Usare quando command = pack.

Specifica il percorso di base dei file definiti nel file nuspec.


verbosityPack - dettagliato
string. Opzionale. Usare quando command = pack. Valori consentiti: Quiet, Normal, Detailed. Valore predefinito: Detailed.

Specifica la quantità di dettagli visualizzati nell'output.


arguments - comandi e argomenti
string. Obbligatorio quando command = custom.

Specifica il comando e gli argomenti che verranno passati a NuGet.exe per l'esecuzione. Se si usa NuGet 3.5 o versione successiva, i comandi autenticati come list, restoree publish in qualsiasi feed in questa organizzazione o raccolta a cui il servizio di compilazione della raccolta progetti può accedere verrà autenticato automaticamente.


Opzioni di controllo attività

Tutte le attività hanno opzioni di controllo oltre ai relativi input di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Importante

L'attività di autenticazione NuGet è il nuovo modo consigliato per eseguire l'autenticazione con Azure Artifacts e altri repository NuGet. Questa attività non accetta più nuove funzionalità e vengono risolti solo i bug critici.

Usare questa attività per installare e aggiornare le dipendenze del pacchetto NuGet o creare pacchetti NuGet e pubblicare pacchetti NuGet. Usa NuGet.exe e funziona con le app .NET Framework. Per le app .NET Core e .NET Standard, usare l'attività .NET Core.

Se il codice dipende dai pacchetti NuGet, assicurarsi di aggiungere questo passaggio prima dell'attività di compilazione di Visual Studio . Assicurarsi anche di deselezionare la casella di controllo Deprecata Ripristina pacchetti NuGet in tale attività.

Se si usa .NET Core o .NET Standard, usare l'attività .NET Core, che include il supporto completo per tutti gli scenari di pacchetto ed è attualmente supportato da dotnet.

Mancia

Questa versione dell'attività NuGet usa NuGet 4.1.0 per impostazione predefinita. Per selezionare una versione diversa di NuGet, usare il programma di installazione dello strumento di .

Schemi di controllo delle versioni

Per byPrereleaseNumber, la versione verrà impostata sui valori scelti per la versione principale, la versione secondaria e la patch, oltre alla data e all'ora, nel formato yyyymmdd-hhmmss.

Per byEnvVar, la versione verrà impostata sul valore della variabile di ambiente con il nome specificato dal parametro versionEnvVar, ad esempio MyVersion (nessuna $, solo il nome della variabile di ambiente). Assicurarsi che la variabile di ambiente sia impostata su un SemVer appropriato, ad esempio 1.2.3 o 1.2.3-beta1.

Per byBuildNumber, la versione verrà impostata usando il numero di build dell'esecuzione della pipeline. Questo è il valore specificato per la proprietà name della pipeline, che viene salvata nella variabile di ambiente BUILD_BUILDNUMBER). Assicurarsi che il numero di build usato contenga un SemVer appropriato, ad esempio 1.0.$(Rev:r). Quando si usa byBuildNumber, l'attività estrae la versione punteggiata, 1.2.3.4, dalla stringa del numero di build e usa solo tale parte. Il resto della stringa verrà eliminato. Se si vuole usare il numero di build così come è, è possibile usare byEnvVar come descritto in precedenza e impostare versioneEnvVar su BUILD_BUILDNUMBER.

Eseguire la migrazione da NuGetInstaller@0 o NuGetRestore@1

NuGetInstaller@0 e NuGetRestore@1 sono deprecati ed è necessario sostituirli nella pipeline con NuGetCommand@2.

Se si usa NuGetInstaller@0 con restoreMode: restore, configurare gli input seguenti quando si usa NuGetCommand@2.

NuGetCommand@2 input dell'attività Valore
command restore
restoreSolution Percorso del file .sln

Se si usa NuGetInstaller@0 con restoreMode: install, configurare gli input seguenti quando si usa NuGetCommand@2.

NuGetCommand@2 input dell'attività Valore
command custom
arguments L'aspetto del comando di installazione completo nell'interfaccia della riga di comando di NuGet. Ad esempio, se si vuole eseguire l'equivalente di nuget install ninject -OutputDirectory c:\proj nella pipeline, il parametro arguments sarà install ninject -OutputDirectory c:\proj. Se si usa il parametro NuGetInstaller@0nuGetRestoreArgs, questi vengono ora visualizzati anche in arguments.

Se si usa NuGetRestore@1, configurare gli input seguenti quando si usa NuGetCommand@2.

NuGetCommand@2 input dell'attività Valore
command restore
restoreSolution Percorso del file .sln

Analogamente all'uso di NuGetRestore@1 o dell'opzione NuGetInstaller@0restore, NuGetCommand@2 include input per impostare il feed, decidere tra select o config, specificare il percorso del file di NuGet.config e usare i pacchetti di nuget.org.

Per altre informazioni, vedere gli esempi di seguenti.

Supporto per immagini ospitate ubuntu più recenti

A partire da Ubuntu 24.04, gli agenti ospitati da Microsft non verranno forniti con mono che è necessario per eseguire il client NuGet sottostante che alimenta NuGetCommand@2. Gli utenti di questa attività in Ubuntu devono eseguire la migrazione all'attività multipiattaforma supportata a lungo termine NuGetAuthenticate@1 con l'interfaccia della riga di comando di .NET.

Migrazione all'interfaccia della riga di comando di .NET in Ubuntu

L'attività Autenticazione NuGet gestirà l'inserimento delle credenziali nelle posizioni necessarie per l'autenticazione degli strumenti client come identità della pipeline. Vedere la documentazione collegata per istruzioni, domande frequenti ed esempi per l'uso di NuGet Authenticate con dotnet.

Se comandi dell'interfaccia della riga di comando dotnet non supportano lo scenario, segnalare questo problema al team dell'interfaccia della riga di comando di .NET come problema. È possibile continuare a aggiungere l'immagine dell'agente a Ubuntu 22.04 o versioni precedenti. Il supporto di Ubuntu 22.04 continuerà fino a quando Ubuntu 26.04 non sarà reso disponibile a livello generale, non prima della versione 2026.

Esempi

Restaurare

Ripristinare tutte le soluzioni con pacchetti da un feed selezionato.

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

Pacco

Creare un pacchetto NuGet nella cartella di destinazione.

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

Spingere

Nota

Gli artefatti della pipeline vengono scaricati nella directory Pipeline.Workspace e nella directory System.ArtifactsDirectory per le pipeline di versione classiche. packagesToPush valore può essere impostato rispettivamente su $(Pipeline.Workspace)/**/*.nupkg o $(System.ArtifactsDirectory)/**/*.nupkg.

  • Eseguire il push/pubblicazione di un pacchetto in un feed definito nel NuGet.config.

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg'
        feedsToUse: 'config'
        nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
    
  • Eseguire il push/pubblicazione di un pacchetto in un feed con ambito organizzazione

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-organization-scoped-feed'
    
  • Eseguire il push/pubblicazione di un pacchetto in un feed con ambito progetto

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-project/my-project-scoped-feed'
    
  • Eseguire il push o la pubblicazione di un pacchetto in NuGet.org

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

Costume

Eseguire qualsiasi altro comando NuGet oltre a quelli predefiniti: pack, push e ripristino.

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

Fabbisogno

Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Viene eseguito in Agente, DeploymentGroup
richieste Nessuno
funzionalità di Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Qualunque
variabili impostabili Qualunque
Versione dell'agente 2.144.0 o versione successiva
Categoria attività Pacco
Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Viene eseguito in Agente, DeploymentGroup
richieste Nessuno
funzionalità di Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Qualunque
variabili impostabili Qualunque
Versione dell'agente 2.115.0 o versione successiva
Categoria attività Pacco