Use this page to include custom actions in your connection profiles when users connect to your service. You can use these actions to enhance the connection experience for your users by providing additional programs that start automatically during the connection to your service. Custom actions can start automatically and use programs that users have already installed or that you include and install with your service profile.

SettingDescription

Action type

Filters the Custom actions list to include only actions of the selected type.

Custom actions

Dislays the list of custom actions that are currently defined in the connection profile. Some might already be present due to your selections in previous pages of the wizard. When the profile is used on the client computer, the actions are run in the order displayed. You can change the order by selecting an action and then pressing the up or down arrows next to the list.

New

Add a new custom action to the connection profile. See the New/Edit Custom Action section of this topic.

Edit

Edits an existing custom action. See the New/Edit Custom Action section of this topic.

Delete

Removes the selected custom action from the list.

New/Edit Custom Action dialog box

When you choose to add or edit a custom action, this dialog box allows you to configure the action.

SettingDescription

Description

Specifies the name of this custom action.

Program to run

Specifies the command, executable program, dynamic-link library (DLL), or batch file to run to carry out this custom action. If the file is already present on the client computers, then specify the path where the file is located. You can use environment variables, such as %SystemRoot%.

Parameters

Specifies the required command-line options for the custom action. If the program is a DLL, then the first parameter is typically the name of the function in the DLL that is to be invoked.

Action type

Specifies when, during the connection process, the action is invoked. Options include:

  • Pre-init

  • Pre-connect

  • Pre-dial (for dial-up connections only)

  • Pre-tunnel (for VPN connections only)

  • Post-connect

  • Monitored

  • Disconnect

  • On cancel

  • On error

Run this custom action for

Specifies the condition under which the custom action is performed. Options include:

  • All connections

  • All connections that involve dial-up

  • All connections that involve a tunnel

  • Connections that use only a tunnel

  • Connections that use only dial-up

Include the custom action program with this service profile

If the executable program for this action is not part of the standard deployment for your client computers, then you can include the file in the profile to be installed when the user installs the connection profile. The file is installed in the folder that contains the connection profile.

Program interacts with the user

Specifies that Connection Manager will run the custom action only if it is in an interactive state. If this check box is not selected and Connection Manager is in a non-interactive state, then a program called by the custom action that attempts to interact with the user will halt the connection process indefinitely, waiting for a response from the user.

Require Elevation

Specifies that the custom action requires the use of administrative privileges to complete. If User Account Control is enabled, selecting this check box causes Connection Manager to prompt the user for permission to continue (if the user is a member of the Administrators group) or for administrator credentials (if the user is not a member of the Administrators group).

For more information about custom actions, the action types, and the variable replaceable parameters, see Incorporating Custom Actions (https://go.microsoft.com/fwlink/?LinkId=80965) on the Microsoft Web site.

Additional references