Partager via

CmdLine@2 - Tâche de ligne de commande v2

Utilisez cette tâche pour exécuter un script de ligne de commande à l’aide de Bash sur Linux, macOS et cmd.exe sur Windows.

Syntaxe

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

Entrées

script - script
string. Obligatoire. Valeur par défaut : echo Write your commands here\n\necho Hello world.

Contenu du script que vous souhaitez exécuter.


workingDirectory - répertoire de travail
string.

Spécifie le répertoire de travail pour exécuter les commandes. Si vous la laissez vide, le répertoire de travail est $(Build.SourcesDirectory).


failOnStderr - Échec sur les d’erreur standard
boolean. Valeur par défaut : false.

Si la valeur est définie sur true, la tâche échoue si des erreurs sont écrites dans le flux d’erreur standard.


Options de contrôle de la tâche

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

Variables de sortie

Aucun.

Remarques

La ligne de commande a un raccourci dans YAML : steps.script.

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

Exécution du lot et . Fichiers CMD

Azure Pipelines place le contenu de votre script inline dans un fichier de commandes temporaire (.cmd) afin de l’exécuter. Lorsque vous souhaitez exécuter un fichier de commandes à partir d’un autre fichier batch dans Windows CMD, vous devez utiliser la commande call ; sinon, le premier fichier batch est arrêté. Cela entraîne l’exécution du script prévu par Azure Pipelines jusqu’au premier fichier de commandes, puis l’exécution du fichier de commandes, puis la fin de l’étape. Les lignes supplémentaires du premier script ne sont pas exécutées. Vous devez toujours prédéfini call avant d’exécuter un fichier de commandes dans une étape de script Azure Pipelines.

Important

Vous risquez de ne pas vous rendre compte que vous exécutez un fichier batch. Par exemple, npm sur Windows, ainsi que tous les outils que vous installez à l’aide de npm install -g, sont en fait des fichiers batch. Utilisez toujours call npm <command> pour exécuter des commandes NPM dans une tâche de ligne de commande sur Windows.

Exemples

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

Spécifications

Besoin Descriptif
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 N'importe quel
variables settables N'importe quel
Version de l’agent Toutes les versions de l’agent prises en charge.
Catégorie de tâche Utilité

Voir aussi