Differences

This shows you the differences between the selected revisions of the page.

2006-08-16 2007-04-03
no summary (202.108.126.162) 4.0 ftp (martin)
Line 3: Line 3:
<code> <code>
-winscp3.exe stored_session +winscp.exe stored_session 
-winscp3.exe [(scp|sftp)://][user[:password]@]host[:port][/path/[file]] [/privatekey=key_file] +winscp.exe [(sftp|ftp|scp)://][user[:password]@]host[:port][/path/[file]] [/privatekey=key_file] 
-winscp3.exe [session] /upload file1 file2 file3 ... [/defaults] +winscp.exe [session] /upload file1 file2 file3 ... [/defaults] 
-winscp3.exe [session] /synchronize [local_directory] [remote_directory] [/defaults] +winscp.exe [session] /synchronize [local_directory] [remote_directory] [/defaults] 
-winscp3.exe [session] /keepuptodate [local_directory] [remote_directory] [/defaults] +winscp.exe [session] /keepuptodate [local_directory] [remote_directory] [/defaults] 
-winscp3.exe [session] [/console] [/script=script_file] [/command command1 command2 ...] +winscp.exe [session] [/console] [/script=script_file] [/command command1 command2 ...] 
-winscp3.exe /update +winscp.exe /update 
-winscp3.exe /ini=<inifile> /log=<logfile> +winscp.exe /ini=<inifile> /log=<logfile> 
-winscp3.exe /help+winscp.exe /help
</code> </code>
The first syntax opens the stored session. The second creates the session specified by at least hostname, optionally 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. If the remote path is not ended by slash (''/''), it is treated as path to file (or even directory) that should be downloaded. Special characters (like ''@'' in username) can be encoded using ''%XX'' syntax, where ''XX'' is hexadecimal ASCII code. The first syntax opens the stored session. The second creates the session specified by at least hostname, optionally 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. If the remote path is not ended by slash (''/''), it is treated as path to file (or even directory) that should be downloaded. Special characters (like ''@'' in username) can be encoded using ''%XX'' syntax, where ''XX'' is hexadecimal ASCII code.
Line 23: Line 23:
Use ''/defaults'' parameter along with ''/upload'', ''/synchronize'' or ''/keepuptodate'' to skip the settings dialog and start the operation straight away with default settings. Use ''/defaults'' parameter along with ''/upload'', ''/synchronize'' or ''/keepuptodate'' to skip the settings dialog and start the operation straight away with default settings.
-Parameter ''/console'' executes WinSCP in [[scripting|console (scripting) mode]]. Note that when WinSCP is executed via [[scripting#console|console interface (WinSCP3.com)]], the ''/console'' parameter is not necessary. +Parameter ''/console'' executes WinSCP in [[scripting|console (scripting) mode]]. Note that when WinSCP is executed via [[scripting#console|console interface (winscp.com)]], the ''/console'' parameter is not necessary.
To run batch script either pass script file using ''/script'' parameter or specify the commands directly on command line using ''/command''. In the latter case each following parameter is treated as single command (If the command includes spaces, enclose it in quotes). If both ''/script'' and ''/command'' parameters are used, commands from script file are executed first. When the last command is not ''exit'', regular non-batch mode follows. If ''/console'' parameter is not used along with ''/script'' or ''/command'', the script/command is executed without visual feedback (window). To run batch script either pass script file using ''/script'' parameter or specify the commands directly on command line using ''/command''. In the latter case each following parameter is treated as single command (If the command includes spaces, enclose it in quotes). If both ''/script'' and ''/command'' parameters are used, commands from script file are executed first. When the last command is not ''exit'', regular non-batch mode follows. If ''/console'' parameter is not used along with ''/script'' or ''/command'', the script/command is executed without visual feedback (window).
Line 35: Line 35:
Parameter ''/help'' shows usage (overview similar to this). Parameter ''/help'' shows usage (overview similar to this).
-For security reasons, when protocol (''%%sftp://%%'' or ''%%scp://%%'') is provided on command line (possible execution from web browser/Windows Explorer), all command-like parameters that cause any automatic action are ignored, including ''/defaults'', ''/log'', ''/script'' and ''/command''.+For security reasons, when protocol (''%%sftp://%%'', ''%%ftp://%%'' or ''%%scp://%%'') is provided on command line (possible execution from web browser/Windows Explorer), all command-like parameters that cause any automatic action are ignored, including ''/defaults'', ''/log'', ''/script'' and ''/command''.

Last modified: by martin