This is an old revision of the document!

Raw Configuration

You can use raw configuration to setup rare advanced global settings.

In scripting, use /rawconfig parameter (when the settings cannot be configured using dedicated command-line parameter or scripting command).

In .NET assembly, use Session.AddRawConfiguration method (when the settings cannot be configured using any dedicated property of Session class).

Advertisement

Common Advanced Settings

Name Description Values
Interface\ExternalIpAddress External IP address
Configuration\Interface\KeepUpToDateChangeDelay Upload delay after change is detected while Keeping remote directory up to date In milliseconds.
Interface\CopyParam\FileNameCase File name case modification 0 = No change, 1 = Upper case, 2 = Lower case, 4 = Lower case 8.3
Interface\CopyParam\ReplaceInvalidChars Replace ‘\:*?’ 0 = Do not replace, 1 = replace with %XX, where the XX is a hexadecimal code of the invalid character, any other value = replace with the character specified by the option value (e.g. 95 for an underscore)
Interface\LocalIconsByExt Turn off loading icons from local files 0 - Load icons from local files, 1 - Resolve icons for local files by file extension only
Interface\LocaleSafe Language Decimal LCID of the language/locale. E.g. 1033 for English (United States)
Logging\LogSensitive Log passwords and other sensitive information 0 - Off, 1 - On
In the scripting, use a command-line switch /loglevel=*.

Other Settings

To find correct syntax for settings not listed above, configure the setting in the GUI, save configuration to an INI file and use the same syntax as you find an INI file.

Advertisement

The settings is identified using syntax section\name, where the section is a path to configuration section from [Configuration] section in an INI file.1 E.g. to configure a setting ExternalIpAddress in section [Configuration\Interface], use Interface\ExternalIpAddress.

Example

For example to configure an External IP address, in scripting:

winscp.com /rawconfig Interface\ExternalIpAddress=198.51.100.10 /script=...

or in .NET assembly (using PowerShell):

$session.AddRawConfiguration("Interface\ExternalIpAddress", "198.51.100.10")
  1. Or HKEY_CURRENT_USER\Software\Martin Prikryl\WinSCP 2\Configuration key in a registryBack

Last modified: by martin