Exec, tâche
Exécute la commande ou le programme spécifié à l'aide des 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. |
CustomErrorRegularExpression |
Paramètre String facultatif. Spécifie une expression régulière permettant de repérer les lignes d'erreur dans la sortie de l'outil. Cela est utile pour les outils qui produisent une sortie dans un format inhabituel. |
CustomWarningRegularExpression |
Paramètre String facultatif. Spécifie une expression régulière permettant de repérer les lignes d'avertissement dans la sortie de l'outil. Cela est utile pour les outils qui produisent une sortie dans un format inhabituel. |
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. |
IgnoreStandardErrorWarningFormat |
Paramètre Boolean facultatif. Si la valeur est false, les lignes dans la sortie qui correspondent au format d'erreur/avertissement standard sont sélectionnées et journalisées en tant qu'erreurs/avertissements. Si la valeur est true, désactiver ce comportement. |
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 l'encodage du flux d'erreur standard de la tâche capturé. La valeur par défaut est l'encodage de sortie de la console active. |
StdOutEncoding |
Paramètre de sortie String facultatif. Spécifie l'encodage du flux de sortie standard de la tâche capturé. La valeur par défaut est l'encodage de sortie de la console active. |
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. Cependant, contrairement à une tâche plus spécifique, la tâche Exec ne peut 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.
En plus des paramètres énumérés dans ce document, cette tâche hérite des paramètres de la classe ToolTaskExtension, qui hérite elle-même de la classe ToolTask. Pour obtenir la liste de ces paramètres supplémentaires et de leurs descriptions, consultez Classe de base ToolTaskExtension.
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>