Generate/SecureFXsysicon.jpg  Command-Line Usage (GUI only)


You can start SecureFX and specify further options and arguments from the command line. Command-line instructions must have the following syntax:

SecureFX [Options] Host

The table below lists the options recognized by SecureFX with their applicable arguments.

Option

Description

/ConfigPassphrase passphrase

Specifies the configuration passphrase. This option allows SecureFX to run unattended when the configuration is passphrase protected.

/Log  path/filename

Turns on logging for the SecureFX session and writes to the specified file.

/Firewall  firewall name

Connects session using specified firewall settings. The format of this command is as follows:

/Firewall=<name>

If the firewall name contains spaces, it should be enclosed by quotation marks.

Note: The /Firewall command must come before the /S session command.

If no firewall argument is specified, SecureFX will use the firewall specified by the session being connected. If the session firewall is set to None, SecureFX will use the firewall specified in the Default Session. If a firewall is named in the command argument, SecureFX will temporarily override the session’s firewall settings and use the firewall specified for the current session (see example below).

 

The table below lists the hosts recognized by SecureFX with their applicable arguments. A host can include either a file or folder.

Host

Description

URL

Opens the program to the specified URL.

FTP URLs must be in the following format:

ftp://[<user>[:<password>]@]<host address>[:<port>][/<path>]

HTTPS URLs must be in the following format:

https://[<user>[:<password>]@]<host address>[:<port>][/<path>]

HTTP URLs must be in the following format:

http://[<user>[:<password>]@]<host address>[:<port>][/<path>]

SFTP URLs must be in the following format:

sftp://[<user>[:<password>]@]<host address>[:<port>][/<path>]

FTP/TLS URLs must be in the following format:

ftps://[<user>[:<password>]@]<host address>[:<port>][/<path>]:

SCP URLs must be in the following format:

scp://[<user>[:<password>]@]<host address>[:<port>][/<path>]

Hostname

Opens the program to the specified host or IP address [Every site that is reachable on the Internet must have a valid IP, or Internet Protocol,address. An IP address should be entered as four numbers separated by period (.) characters (for example: 198.105.232.1).]

/S  session path

Opens the program to a specific session.

The session path must be the full path of a session profile in the database as in the following example:

"/Software/Commercial Software/VanDyke Software"

If the pathname contains spaces, enclose it in quotation marks.

/Session_Folder folder

Opens the sessions in the specified folder that would be opened if the folder was designated as an auto session. To open all the sessions, use the following command:

/Session_Folder \

The / Session_Folder option cannot be used with the /S option.

Examples

Connecting to named sessions:

SecureFX.exe /S /ftp.vandyke.com

Tip: Use quotation marks on the command line if the path contains spaces:

SecureFX.exe /S "/Software/Commercial Software/VanDyke Software"

Connecting to host addresses:

SecureFX.exe ftp.vandyke.com

or

SecureFX.exe 192.168.0.1

Connecting to URLs:

SecureFX.exe <FTP, SFTP, or HTTPS URL>

where the FTP, SFTP, or HTTPS URL is of the following form:

ftp://[<user>[:<password>]@]<host address>[:<port>][/<path>]

or

sftp://[<user>[:<password>]@]<host address>[:<port>][/<path>]

or

https://[user>[:<password>]@]<host address>[:<port>][/<path>]

For example:

ftp://bob:r2d2c3po@vandyke.com:22/Documents/Spreadsheets/

or

sftp://username: password@OurSFTPServer/pub/vim/vim57

or

https://username:bob:r2d2c3pO@OurHTTPSServer:443/bob/docs

Connecting to a session using a specific firewall:

securefx.exe /Firewall=my_firewall /S my_session