Navigation:  Actions > Miscellaneous >

Kill Process Action

Previous pageReturn to chapter overviewNext page

The Kill Process action can be used to kill a Windows process, given its process ID or a Windows executable filename.

 

Computer name: Remote computer to kill the process on (optional, uses local computer if blank).

 

Process ID or executable filename: The process ID (base 10) or executable filename (i.e., Notepad.exe) of the process to kill. Note: [Builder.ProcessID] can be used to kill the current build process.

 

Use wildcard search: If unchecked, the executable filename must match exactly (non-case-sensitive).  If checked, when searching on an executable filename, wildcards can be used for matching:

 

[[ ]]        Any one character within the specified range ([[a=f]]) or set ([[aef]]).

^        Any one character not within the range ([[^a=f]]) or set ([[^aef]]).

%%        Any string of 0 (zero) or more characters (%%Win%%).

_        Any one character.  A literal underscore must be escaped by placing inside brackets ([[_]]).

 

When the step completes, the following temporary macros are created or updated:

KILLPROCESS_COUNT = The number of processes that were terminated

 

Note: This action utilizes WMI, and your network configuration may need to be adjusted to allow WMI to operate through Windows Firewall; see this article for more details.