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

Article
07/02/2024

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.

Syntax

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

script - Script
string. Obligatoire. Valeur par défaut : echo Write your commands here\n\necho Use the environment variables input below to pass secret variables to this script.

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 le laissez vide, le répertoire de travail est $(Build.SourcesDirectory).

failOnStderr - Échec en cas 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.

Notes

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

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

Exécution de fichiers de commandes et .CMD

Azure Pipelines place le contenu de votre script inline dans un fichier de commandes temporaire (.cmd) afin de l’exécuter. Quand vous souhaitez exécuter un fichier de commandes à partir d’un autre fichier de commandes dans Windows CMD, vous devez utiliser la commande call, sinon le premier fichier de commandes 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 ajouter call avant d’exécuter un fichier de commandes dans une étape de script Azure Pipelines.

Important

Vous ne réalisez peut-être pas que vous exécutez un fichier de commandes. Par exemple, npm sur Windows, ainsi que tous les outils que vous installez à l’aide de npm install -g, sont en fait des fichiers de commandes. Utilisez toujours call npm <command> pour exécuter des commandes NPM dans une tâche 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

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	None
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes	Quelconque
Variables settables	Quelconque
Version de l’agent	Toutes les versions d’agent prises en charge.
Catégorie de la tâche	Utilitaire

Voir aussi

Découvrez comment utiliser des journaux détaillés pour la résolution des problèmes.

Partage via