General
Short Name
Short text string that when typed into the Run++ prompt will launch this command. The short name should not contain any of the following characters '*', '%', '[', or ']'.
File Name or Web Address
The following are a list of valid items that can be used in this field.
The full local or UNC path to an executable file.
Click the button next to the textbox to browse the file system to select an executable file or click and drag the magnifying glass over top of a window to retrieve the executable file associated with that window. You can also provide an alternative set of user credentials to run this executable
under, similar to what you can do with RunAs. Those user credentials will also be used for network authentication if
the path to the executable is a UNC path.
If the selected executable is a console application there is a program wide
option to keep the console window open after the command has executed that way
you can see the output.
The full path to a file that has an associated file type on the system.
The full local or UNC path to a directory.
If a UNC path is provided you may also provide an alternative set of
user credentials to use for the network authentication.
The address of a web site, it must start with http:, https:, or www.
The web address is just passed to ShellExecute so it will pass the URL to your default browser. There is a program option to launch web addresses in a separate browser window; this is done by creating a new instance of your default browser and passing it the URL as an argument. If a web address is provided you can provide parameters in this field since the Arguments field is not used for web addresses.
Arguments
The arguments are command line arguments that get passed to the executable when this command is executed. Arguments are only used for Executable Files, they should not be used for an Associated File, Directory, or Web Address.
Parameters maybe used in the Arguments field for Executable
files and in the Web Address field for Web Addresses.
There can be any number of parameters
of the format {0}, {1}, {2},..., {N} where N is the parameter index, {*} is special in
that it concatenates all the parameters together separated by a single space. The parameters
are determined by splitting
the typed command by white space, so if you want a single parameter to
contain white
space be sure to put quotes around it.
Parameter examples:
| Typed Command | {0} | {1} | {2} | {*} |
| cmdName p1 p2 p3 | p1 | p2 | p3 | p1 p2 p3 |
| cmdName p1 "p2 p3" p4 | p1 | "p2 p3" | p4 | p1 "p2 p3" |
For more parameter examples see sample commands.
Advanced
Hotkey
This wil be the global hotkey associated with this command, so whenever you press that hotkey combination this command is executed.
The hotkey textbox captures all the key strokes and displays the key combination. A valid hotkey must contain at least one modifier (i.e. Shift, Control, Alt, or Win) and a single virtual key (i.e. any other key that is not a modifier). If you enter a hotkey that is already registered as a system wide global hotkey the textbox will turn yellow as a warning. You are able to override any hotkey combination with the exception of "Ctrl+Alt+Delete", but it is not guaranteed to work all the time and it is only advisable if you fully understand what you are doing.
Window Style
A window style of Normal, Minimized, Maximized, or Hidden can be provided as the startup window state for this command. If nothing is provided it defaults to normal.
Working Directory
If the command needs a specific working directory it can be provided here.
User Information
The user credentials are used for two different things.
Network Authentication
If the File Name field contains a UNC path then before the command is executed an attempt is made to make an IPC connection to the target computer using the entered user credentials.
Process Authentication
If the File Name field contains a path to an Executable File then and attempt is made to start that executable process with the entered user credentials. If the attempt fails then you will be prompted to enter a username and password to start the command.
Username
The username of the user that this command should be ran under. If it is a network user be sure to include the domain i.e. domain\username or username@domain
Password
The password of the user that this command should be ran under. If a password is not provided but a username is then when this command is executed you will be prompted to enter the password. The password is encrypted using the new DataProtect API in .Net 2.0 see How to store secrets on a Machine for more details.
