<cfexecute>

Enables developers to execute a process on a server computer.

This tag must have a body.

This tag is also supported within <cfscript>

<cfexecute name=string arguments=any outputfile=string timeout=number terminateontimeout=boolean variable=string errorfile=string errorvariable=string ><!--- body ---></cfexecute>
Attribute Description
name
string, optional

The full pathname of the application to execute.

Note: On Windows, you must specify the extension as part of the application's name. For example, myapp.exe,

arguments
any, optional

Command-line arguments passed to the application.

outputfile
string, optional

The file to which to direct the output of the program. If not specified, the output is displayed on the page from which it was called.

timeout
number, optional

Indicates how long, in seconds, the executing thread waits for the spawned process.

A timeout of 0 is equivalent to the non-blocking mode of executing. A very high timeout value is equivalent to a blocking mode of execution. The default is 0; therefore, the thread spawns a process and returns without waiting for the process to terminate.If no output file is specified, and the timeout value is 0, the program output is discarded.

terminateontimeout
boolean, optional

terminate execution of process when timeout occur. Defaults to false.

variable
string, optional

Variable in which to put program output.

If no output file or variable attribute is specified, output is displayed on page from which it was called.

errorfile
string, optional

The file to which to direct the error stream of the program. If neither errorFile nor errorVariable is specified, the error stream is discarded.

errorvariable
string, optional

Variable in which to put program error stream output. If neither errorFile nor errorVariable is specified, the error stream is discarded.

Examples

Simple example for cfexecute

<cfexecute name="C:\Windows\System32\netstat.exe"
            arguments="-e"
            outputFile="C:\Temp\output.txt"
            timeout="1">
</cfexecute>

See also