CmdLine@2 - Attività della riga di comando v2

Articolo
02/24/2025

Usare questa attività per eseguire uno script della riga di comando usando Bash in Linux, macOS e cmd.exe in Windows.

Sintassi

# Command Line v2
# Run a command line script using Bash on Linux and macOS and cmd.exe on Windows.
- task: CmdLine@2
  inputs:
    script: # string. Required. Script. 
  # Advanced
    #workingDirectory: # string. Working Directory. 
    #failOnStderr: false # boolean. Fail on Standard Error. Default: false.

Input

script - Copione
string. Obbligatorio. Valore predefinito: echo Write your commands here\n\necho Hello world.

Contenuto dello script da eseguire.

script - Copione
string. Obbligatorio. Valore predefinito: echo Write your commands here\n\necho Use the environment variables input below to pass secret variables to this script.

Contenuto dello script da eseguire.

workingDirectory - Directory di lavoro
string.

Specifica la directory di lavoro in cui eseguire i comandi. Se lo si lascia vuoto, la directory di lavoro è $(Build.SourcesDirectory).

failOnStderr - Errore standard non riuscita
boolean. Valore predefinito: false.

Se il valore è impostato su true, l'attività ha esito negativo se vengono scritti errori nel flusso di errore standard.

Opzioni di controllo delle attività

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

Variabili di output

Nessuno.

Osservazioni

La riga di comando ha un collegamento in YAML: steps.script.

- script: # inline script
  workingDirectory: #
  displayName: #
  failOnStderr: #
  env: { string: string } # mapping of environment variables to add

Esecuzione di batch e . File CMD

Azure Pipelines inserisce il contenuto dello script inline in un file batch temporaneo (con estensione cmd) per eseguirlo. Quando si vuole eseguire un file batch da un altro file batch in Windows CMD, è necessario usare il call comando, altrimenti il primo file batch viene terminato. In questo modo Azure Pipelines eseguirà lo script previsto fino al primo file batch, quindi eseguirà il file batch e terminerà il passaggio. Le righe aggiuntive nel primo script non vengono eseguite. Prima di eseguire un file batch in un passaggio script di Azure Pipelines, è consigliabile prepende call sempre prima di eseguire un file batch.

Importante

È possibile che non si verifichi l'esecuzione di un file batch. Ad esempio, in Windows, npm insieme a tutti gli strumenti installati tramite npm install -g, sono effettivamente file batch. Usare call npm <command> sempre per eseguire comandi NPM in un'attività della riga di comando in Windows.

Esempio

steps:
- script: date /t
  displayName: Get the date
- script: dir
  workingDirectory: $(Agent.BuildDirectory)
  displayName: List contents of a folder
- script: |
    set MYVAR=foo
    set
  displayName: Set a variable and then display all
  env:
    aVarFromYaml: someValue

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Esecuzione in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	Tutte le versioni dell'agente supportate.
Categoria attività	Utilità

Vedi anche

Informazioni su come usare i log dettagliati per la risoluzione dei problemi.

Condividi tramite