Exec (Tarea)Exec Task

Ejecuta el programa o comando especificado mediante los argumentos especificados.Runs the specified program or command by using the specified arguments.

ParámetrosParameters

En la tabla siguiente se describen los parámetros de la tarea Exec.The following table describes the parameters for the Exec task.

ParámetroParameter DescriptionDescription
Command Parámetro String requerido.Required String parameter.

Comandos que se van a ejecutar.The command(s) to run. Estos pueden ser comandos del sistema, como attrib, o una aplicación ejecutable, como program.exe, runprogram.bat o setup.msi.These can be system commands, such as attrib, or an executable, such as program.exe, runprogram.bat, or setup.msi.

Este parámetro puede contener varias líneas de comandos.This parameter can contain multiple lines of commands. Alternativamente, puede colocar varios comandos en un archivo por lotes y ejecutarlo utilizando este parámetro.Alternatively, you can put multiple commands in a batch file and run it by using this parameter.
ConsoleOutput Parámetro de salida ITaskItem[] opcional.Optional ITaskItem[] output parameter.

La salida de cada elemento es una línea de la salida estándar o de la secuencia de errores estándar que emite la herramienta.Each item output is a line from the standard output or standard error stream emitted by the tool. Solo se captura si ConsoleToMsBuild está establecido en true.This is only captured if ConsoleToMsBuild is set to true.
ConsoleToMsBuild Parámetro Boolean opcional.Optional Boolean parameter.

Si se establece en true, la tarea capturará el error estándar y la salida estándar de la herramienta y hará que estén disponibles en el parámetro de salida ConsoleOutput.If true, the task will capture the standard error and standard output of the tool and make them available in the ConsoleOutput output parameter. El valor predeterminado es false.The default value is false.
CustomErrorRegularExpression Parámetro String opcional.Optional String parameter.

Especifica una expresión regular que se utiliza para identificar líneas de error en los resultados de la herramienta.Specifies a regular expression that is used to spot error lines in the tool output. Esto resulta útil para las herramientas que generan resultados con un formato poco común.This is useful for tools that produce unusually formatted output.
CustomWarningRegularExpression Parámetro String opcional.Optional String parameter.

Especifica una expresión regular que se utiliza para identificar líneas de advertencia en los resultados de la herramienta.Specifies a regular expression that is used to spot warning lines in the tool output. Esto resulta útil para las herramientas que generan resultados con un formato poco común.This is useful for tools that produce unusually formatted output.
EchoOff Parámetro Boolean opcional.Optional Boolean parameter.

Si se establece en true, la tarea no emitirá el formulario expandido de Command al registro de MSBuild.If true, the task will not emit the expanded form of Command to the MSBuild log. El valor predeterminado es false.The default value is false.
ExitCode Parámetro de solo lectura de salida Int32 opcional.Optional Int32 output read-only parameter.

Especifica el código de salida proporcionado por el comando ejecutado.Specifies the exit code that is provided by the executed command.
IgnoreExitCode Parámetro Boolean opcional.Optional Boolean parameter.

Si es true, la tarea omite el código de salida proporcionado por el comando ejecutado.If true, the task ignores the exit code that is provided by the executed command. De lo contrario, la tarea devuelve false si el comando ejecutado devuelve un código de salida distinto de cero.Otherwise, the task returns false if the executed command returns a non-zero exit code.
IgnoreStandardErrorWarningFormat Parámetro Boolean opcional.Optional Boolean parameter.

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.If false, selects lines in the output that match the standard error/warning format, and logs them as errors/warnings. Si es true, se deshabilita este comportamiento.If true, disable this behavior. El valor predeterminado es false.The default value is false.
Outputs Parámetro de salida ITaskItem[] opcional.Optional ITaskItem[] output parameter.

Contiene los elementos de salida de la tarea.Contains the output items from the task. La tarea Exec no los establece por sí misma.The Exec task does not set these itself. En cambio, puede proporcionarlos como si los estableciera, para que se puedan utilizar después en el proyecto.Instead, you can provide them as if it did set them, so that they can be used later in the project.
StdErrEncoding Parámetro de salida String opcional.Optional String output parameter.

Especifica la codificación del flujo de error estándar de la tarea capturada.Specifies the encoding of the captured task standard error stream. El valor predeterminado es la codificación generada de la consola actual.The default is the current console output encoding.
StdOutEncoding Parámetro de salida String opcional.Optional String output parameter.

Especifica la codificación del flujo de salida estándar de la tarea capturada.Specifies the encoding of the captured task standard output stream. El valor predeterminado es la codificación generada de la consola actual.The default is the current console output encoding.
WorkingDirectory Parámetro String opcional.Optional String parameter.

Especifica el directorio en el que se ejecutará el comando.Specifies the directory in which the command will run.

ComentariosRemarks

Esta tarea es útil cuando una tarea de MSBuildMSBuild específica para el trabajo que desea realizar no está disponible.This task is useful when a specific MSBuildMSBuild task for the job that you want to perform is not available. Sin embargo, la tarea Exec, a diferencia de una tarea más específica, no puede realizar un procesamiento adicional ni operaciones condicionales en función del resultado de la herramienta o el comando que se ejecuta.However, the Exec task, unlike a more specific task, cannot do additional processing or conditional operations based on the result of the tool or command that it runs.

La tarea Exec llama al archivo cmd.exe en vez de invocar directamente un proceso.The Exec task calls cmd.exe instead of directly invoking a process.

Además de los parámetros mencionados en este documento, esta tarea hereda los parámetros de la clase ToolTaskExtension, que a su vez hereda de la clase ToolTask.In addition to the parameters listed in this document, this task inherits parameters from the ToolTaskExtension class, which itself inherits from the ToolTask class. Para obtener una lista de estos parámetros adicionales y sus descripciones, consulte ToolTaskExtension (Clase base).For a list of these additional parameters and their descriptions, see ToolTaskExtension Base Class.

EjemploExample

El ejemplo siguiente utiliza la tarea Exec para ejecutar un comando.The following example uses the Exec task to run a command.

<Project xmlns="http://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>  

Vea tambiénSee Also

Tareas Tasks
Referencia de tareasTask Reference