Partager via


Exec, tâche

Mise à jour : novembre 2007

Exécute la commande ou le programme spécifié avec les arguments indiqués.

Paramètres

Le tableau suivant décrit les paramètres de la tâche Exec.

Paramètre

Description

Command

Paramètre String obligatoire.

Commande(s) à exécuter. Il peut s'agir de commandes système, par exemple attrib, ou d'un fichier exécutable, comme program.exe, runprogram.bat ou setup.msi.

Ce paramètre peut contenir plusieurs lignes de commandes. Vous pouvez également placer plusieurs commandes dans un fichier de commandes et l'exécuter à l'aide de ce paramètre.

ExitCode

Paramètre de sortie en lecture seule Int32 facultatif.

Spécifie le code de sortie fourni par la commande exécutée.

IgnoreExitCode

Paramètre Boolean facultatif.

Si la valeur est true, la tâche ignore le code de sortie fourni par la commande exécutée. Sinon, la tâche retourne false si la commande exécutée retourne un code de sortie différent de zéro.

Outputs

Paramètre de sortie ITaskItem[] facultatif.

Contient les éléments de sortie de la tâche. La tâche Exec ne les définit pas elle-même. Au lieu de cela, vous pouvez les fournir comme si la tâche les avait définis, afin qu'ils puissent être utilisés ultérieurement dans le projet.

StdErrEncoding

Paramètre de sortie String facultatif.

Spécifie le codage du flux d'erreur standard de la tâche capturé. La valeur par défaut est le codage de sortie de la console active.

StdOutEncoding

Paramètre de sortie String facultatif.

Spécifie le codage du flux de sortie standard de la tâche capturé. La valeur par défaut est le codage de sortie de la console active.

Timeout

Paramètre Int32 facultatif.

Spécifie la durée, en millisecondes, après laquelle la tâche exécutable est terminée. La valeur par défaut est Int.MaxValue, indiquant qu'il n'existe aucun délai d'attente.

ToolPath

Paramètre String facultatif.

Spécifie l'emplacement à partir duquel la tâche charge le fichier exécutable sous-jacent (cmd.exe).

WorkingDirectory

Paramètre String facultatif.

Spécifie le répertoire dans lequel la commande doit s'exécuter.

Notes

Cette tâche est utile lorsqu'une tâche MSBuild spécifique au travail à effectuer n'est pas disponible. Utiliser la tâche Exec au lieu d'une tâche plus spécifique comporte toutefois un inconvénient : elle ne peut pas recueillir la sortie de l'outil ou de la commande qu'elle exécute.

La tâche Exec appelle cmd.exe au lieu d'appeler directement un processus.

Exemple

L'exemple suivant utilise la tâche Exec pour exécuter une commande.

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <Binaries Include="*.dll;*.exe"/>
    </ItemGroup>

    <Target Name="SetACL">
        <!-- set security on binaries-->
        <Exec Command="echo y| cacls %(Binaries.Identity) /G everyone:R"/>
    </Target>

</Project>

Voir aussi

Concepts

Tâches MSBuild

Autres ressources

Référence des tâches MSBuild