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.

Executable File

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.

Associated File

The full path to a file that has an associated file type on the system.

Directories

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.

Web Addresses

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.

Using Parameters

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.

Setting Hotkeys

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.