Table of Standard Command-Line Options


 

Standard Option

Arguments

Description

/ARG

argument

Passes option(s) to SecureCRT scripts by way of Arguments scripting objects. More than one /ARG option can be used in a command.

/COLOR_
SCHEME

scheme

Specifies an existing color scheme [A combination of session settings that specify a variety of colors associated with the terminal window, including foreground and background.] to be used for the session [A session is a set of options that are assigned to a connection to a remote machine. These settings and options are saved under a session name and allow the user to have different preferences for different hosts.] being started. When this switch is used, any changes to the session color scheme will be ignored. If a nonexistent scheme is specified, the session configuration color scheme will be used.

/CONFIGPASSPHRASE

passphrase

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

/EXPORT

[INCLUDE | /EXCLUDE options] filename

Exports the SecureCRT configuration to an XML file. The "options" variable is a comma-separated list including one or more of: global, sessions, license, scheduled-tasks, button-bars, and/or commands. If no options are present, /INCLUDE or /EXCLUDE should not be present, and all options will be exported.

This operation is silent. No progress window displayed and no completion indicator is given other than exit code 0 = success. A .log file is created in the same location as the XML file.

In the following example, sessions and license data will be exported to the file "MySessionsAndLicense.xml" on the user's desktop. A log file "MySessionsAndLicense.log" will also be placed on the user's desktop.

SecureCRT /EXPORT /INCLUDE sessions,license c:\Users\user\Desktop\MySessionsAndLicense.xml

/F

folder
pathname

Points to an alternate configuration folder location. If there is no configuration file in the alternate folder, SecureCRT will create one. Without this option, SecureCRT will use the configuration information in the default folder location.

/FIREWALL

firewall
name

Connects session using specified firewall settings. Replaces /PROXY and /SOCKS options. The format of this command is as follows:

/FIREWALL=<name>

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

If no firewall argument is specified, SecureCRT will use the firewall specified by the session being connected. If the session firewall is set to None, SecureCRT will use the firewall specified in the current global firewall settings. If a firewall is named in the command argument, SecureCRT will temporarily override the session’s firewall settings and use the firewall specified for the current session.

Note: When specifying a firewall on the same command line used to open multiple sessions, SecureCRT will apply the firewall to each of the sessions.

Using SecureCRT's dependent session option on the command line or in the connect bar (as in the following example), it's possible to link a session to an SSH2 session that it depends on, which allows connection to a jump host before connecting to other sessions.

Both the command line and the connect bar use the normal /Firewall specifier and the firewall will be Session:<session name> with the following syntax.

/FIREWALL=Session:<Session Name> ssh2://[<user>]@<host>

Session: is case insensitive.

/IMPORT

[INCLUDE | /EXCLUDE options] filename

Imports a SecureCRT configuration from an XML file. The "options" variable is a comma-separated list including one or more of: global, sessions, license, scheduled-tasks, button-bars, and/or commands. If no options are present, /INCLUDE or /EXCLUDE should not be present, and all options will be imported.

This operation is silent, No progress window displayed and no completion indicator is given other than exit code 0 = success. A .log file is created in the same location as the XML file.

In the following example, just the sessions from the file "MyConfig.xml" will be imported. A log file "MyConfig.log" will also be placed on the user's desktop.

SecureCRT /IMPORT /INCLUDE sessions c:\Users\user\Desktop\MyConfig.xml

/LOG

filename

Specifies a log file to be used for the session being started.

/MAX_COLS

n

Specifies the maximum number of columns. The maximum value for n is 1024 and the minimum value is 132.

/N

tabname

Specifies the name to display on the tab.

/NOMENU

 

Hides the menu bar.

/NOTOOLBAR

 

Hides the toolbar.

/NOSAVE

 

No changes to settings will be saved.

/POS

x y

Specifies the initial position of the SecureCRT window, where x and y specify the upper left corner of the SecureCRT window in pixel coordinates.

/SCRIPT

filename

Runs script contained in filename.

/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 can be used with the /S option.

/TERMINAL_TYPE

terminal type

Connects session using specified terminal type. Overrides the terminal type specified in the session options. The format of this command is as follows:

/TERMINAL_TYPE=<type>

/TITLEBAR

"Title to display"

Sets the text in the title bar to the string given as argument.

 

Examples of Command Line Usage:

Example:

To launch a new Telnet session, displaying the name "Houston, TX" on the tab, use the following:

/T /N "Houston, TX" /TELNET 192.168.0.6

 

Related Topics

  1. Table of Protocol-Specific Command-Line Options