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>