This is an old revision of the document!

Command-line Options

winscp3.exe stored_session
winscp3.exe [(scp|sftp)://][user[:password]@]host[:port][/path]
winscp3.exe [session] /upload file1 file2 file3 ...
winscp3.exe [session] /synchronize [local_directory] [remote_directory]
winscp3.exe [session] /keepuptodate [local_directory] [remote_directory]
winscp3.exe [session] /console [/script=script_file]
winscp3.exe /update
winscp3.exe /ini=<inifile>
winscp3.exe /help

Advertisement

The first syntax opens the stored session. The second creates the session specified by at least hostname, optionaly by name of protocol, port number, username, password and initial remote path. In both cases, when only hostname is known, only Login dialog is shown with pre-filled hostname. Otherwise connection attempt is started immediately.

With /upload parameter WinSCP uploads specified files to remote directory of session defined using one of the previous syntaxes.

With /synchronize or /keepuptodate parameter WinSCP performs “Synchronize” or “Keep remote directory up to date” commands respectively on specified session and directories. Dialog to set options is displayed first (Note that this is not intended for automation, see scripting).

Parameter /console executes WinSCP in console (scripting) mode. Optional batch script file can be set using /script command. When the script file does not end with exit command, regular non-batch mode follows. Note that when WinSCP is executed via console interface (WinSCP3.com), the /console parameter is not necessary.

When run with /update parametr, WinSCP only checks for new program version on the program website.

With /ini parametr you may specify path to configuration INI file. It effectively disables using registry as configuration storage.

Parameter /help shows usage (overview similar to this). Note that that parameter is useless unless used from console (Windows command line prompt) on WinSCP console interface, WinSCP3.com, (without it the usage would just flash on the screen, dissapearing immediatelly).

Last modified: by martin