Exec (Tarea)
Ejecuta el programa o comando especificado mediante los argumentos especificados.
Parámetros
En la siguiente tabla se describen los parámetros de la tarea Exec.
Parámetro |
Descripción |
|---|---|
Command |
Parámetro String requerido. El comando o comandos que se va a ejecutar. Éstos pueden ser comandos del sistema, como attrib, o una aplicación ejecutable, como program.exe, runprogram.bat o setup.msi. Este parámetro contiene varias líneas de comandos. Alternativamente, puede colocar varios comandos en un archivo por lotes y ejecutarlo utilizando este parámetro. |
CustomErrorRegularExpression |
Parámetro String opcional. Especifica una expresión regular que se utiliza para identificar líneas de error en los resultados de la herramienta. Esto resulta útil para las herramientas que generan resultados con un formato poco común. |
CustomWarningRegularExpression |
Parámetro String opcional. Especifica una expresión regular que se utiliza para identificar líneas de advertencia en los resultados de la herramienta. Esto resulta útil para las herramientas que generan resultados con un formato poco común. |
ExitCode |
Parámetro de salida de sólo lectura Int32 opcional. Especifica el código de salida proporcionado por el comando ejecutado. |
IgnoreExitCode |
Parámetro Boolean opcional. Si es true, la tarea omite el código de salida proporcionado por el comando ejecutado. De lo contrario, la tarea devuelve false si el comando ejecutado devuelve un código de salida distinto de cero. |
IgnoreStandardErrorWarningFormat |
Parámetro Boolean opcional. Si es false, selecciona las líneas de los resultados que coincidan con el formato estándar de alerta/advertencia, y los registra como errores/advertencias. Si es true, deshabilite este comportamiento. |
Outputs |
Parámetro de salida ITaskItem[] opcional. Contiene los elementos de salida de la tarea. La tarea Exec no los establece por sí misma. En cambio, puede proporcionarlos como si los estableciera, para que se puedan utilizar después en el proyecto. |
StdErrEncoding |
Parámetro de salida String opcional. Especifica la codificación del flujo de error estándar de la tarea capturada. El valor predeterminado es la codificación generada de la consola actual. |
StdOutEncoding |
Parámetro de salida String opcional. Especifica la codificación del flujo de salida estándar de la tarea capturada. El valor predeterminado es la codificación generada de la consola actual. |
WorkingDirectory |
Parámetro String opcional. Especifica el directorio en el que el comando se ejecutará. |
Comentarios
Esta tarea es útil cuando una tarea de MSBuild específica para el trabajo que desea realizar no está disponible. Sin embargo, la tarea Exec, a diferencia de una tarea más específica, no puede reunir la salida de la herramienta o comando que ejecuta.
La tarea Exec llama al archivo cmd.exe en vez de invocar directamente un proceso.
Además de los parámetros mencionados en este documento, esta tarea hereda los parámetros de la clase ToolTaskExtension, que hereda de la clase ToolTask. Para obtener una lista de estos parámetros adicionales y sus descripciones, vea ToolTaskExtension (Clase base).
Ejemplo
El ejemplo siguiente utiliza la tarea Exec para ejecutar un comando.
<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>