<cfexecute>

Enables developers to execute a process on a server computer.

This tag may 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
    directory=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.
directory _{string, optional}	The working directory in which to execute the command Introduced: 5.3.8.1

Examples

Simple example for cfexecute

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

<cfexecute>

Examples

Simple example for cfexecute

See also