VPN Client command line
Stop the VPN Client
TheGreenBow VPN Client can be stopped at any time with the command line option: "/stop"
Example: " vpnconf.exe /stop "
This functionality allows the VPN Client to be called within a script, opening the
VPN Client as the network connection is starting, closing the VPN Client as the connection ends.
Note: If one or several tunnels are active, they are correctly closed.
Import a VPN Configuration
TheGreenBow VPN Client can import a specific VPN configuration file using the command line option:
Example: " vpnconf.exe /import:"C:\My documents\config.tgb" "
- /import: may be used whether the VPN Client is running or not. When the VPN Client is already
running, it imports dynamically the new VPN configuration and automatically applies it (i.e. restarts
the IKE service). If the VPN Client is not running, it is launched with the new VPN configuration.
||The "/import" option can be used to open a tunnel with a double-clic on a "tgb" file
(also called the "dial-up" mode): This allows for example to open a tunnel with a double-clic on a 'tgb'
file from the desktop, or to deploy a configuration by email.
- /replace: enables to replace the current configuration by a new VPN Configuration.
- /add: Import a new VPN Configuration into an existing VPN Configuration and merge both
into a single VPN Configuration. This command line may be used either if the VPN Client is
running or not. This command doesn't start the VPN Client if it is not running already.
||Since the release 3.1 of TheGreenBow VPN Client, certificates can be embedded within
a configuration file to be imported. For more details, see the VPN Client User Guide.
Export a VPN Configuration
TheGreenBow VPN Client can export a specific VPN configuration file using the command line option:
Example: " vpnconf.exe /export:"C:\My documents\export.tgb " "
- /export: may be used whether the VPN Client is running or not. When the VPN Client is already
running, it exports dynamically the VPN configuration. If the VPN Client is not running, it is launched
after having exported the configuration.
||All 6 arguments "import", "export", "replace" and "add" are exclusives and cannot be used together.
Best implementations using VPN Client command line
- Devolution: Remote Desktop Manager is an application used to manage all your remote connections and virtual machines. Add, edit, delete, share, organize and find your remote connection quickly. Devolution developed a plugin to start/open tunnels before opening the RDP session and to import a VPN configuration file. Pretty cool, see the tutorial video.
VPN Client Deployment tools
Embedded VPN Configuration
A specific VPN Configuration file can be embedded within the VPN Setup. This VPN Configuration will be automatically imported at the first time the software is run. This feature enables to embed pre-configured VPN configuration and to deploy "customized" setups to end-users.
See our Deployment Guide
for details about how to embed a VPN Configuration in a VPN setup.
VPN Setup Options
The VPN Setup handles several command line options. These options are used to customized the Software installation and must be preceded by 2 dashes.
Enables to embed the license number of the software.
Enables to control the access to the VPN Configuration Panel with a password.
The end-user will be asked for the password:
- when he clicks or double-clicks on the VPN systray icon
- when he wants to switch from the Connection Panel to the Config. Panel.
Enables to define the email to which the software activation confirmation
will be sent. Thus, it enables IT Managers to check each software activation on a single email address. When this
email is pre-configured, it cannot be modified by end-users.