commandline » Revisions »
Differences
This shows you the differences between the selected revisions of the page.
| 2015-02-18 | 2015-02-18 | ||
| moving session logging-only example closer to its description (martin) | releasing 5.7 stable, removing &beta tags (or replacing with &recent) (martin) | ||
| Line 39: | Line 39: | ||
| If there's already idle WinSCP instance running, the session(s) opens in the existing instance. To force session open in new instance of WinSCP, use ''/newinstance'' parameter. | If there's already idle WinSCP instance running, the session(s) opens in the existing instance. To force session open in new instance of WinSCP, use ''/newinstance'' parameter. | ||
| - | |||
| - | For security reasons, when protocol (such as ''%%sftp://%%'') is provided as part of session URL (possible execution from web browser/Windows Explorer), all command-like parameters that cause any automatic action are ignored, including ''/defaults'', ''/log'', ''/script'' and ''/command''. //This restriction no longer applies in the latest beta version.// &beta | ||
| Parameter ''/privatekey'' specifies [[local_path|local path]] to [[public_key#private|SSH private key file]]. | Parameter ''/privatekey'' specifies [[local_path|local path]] to [[public_key#private|SSH private key file]]. | ||
| Line 50: | Line 48: | ||
| Parameter ''/passive'' enables [[ui_login_connection#connection|passive]] (''=on'') or active (''=off'') transfer mode ([[FTP]] protocol only). | Parameter ''/passive'' enables [[ui_login_connection#connection|passive]] (''=on'') or active (''=off'') transfer mode ([[FTP]] protocol only). | ||
| - | Parameters ''/implicit'', and ''/explicittls'' (''/explicit'' //in the latest beta version//&beta) enable respective [[ftps#methods_of_invoking|method of invoking FTPS]]. | + | Parameters ''/implicit'', and ''/explicit'' (''/explicittls'' //in the earlier versions//&recent) enable respective [[ftps#methods_of_invoking|method of invoking FTPS]]. |
| Parameter ''/rawsettings'' allows configuring any site settings using raw format as in an INI file. E.g. to enable SSH compression and agent forwarding use ''/rawsettings Compression=1 AgentFwd=1''. The parameter must come after session URL. | Parameter ''/rawsettings'' allows configuring any site settings using raw format as in an INI file. E.g. to enable SSH compression and agent forwarding use ''/rawsettings Compression=1 AgentFwd=1''. The parameter must come after session URL. | ||
| Line 89: | Line 87: | ||
| With ''[[executables|winscp.exe]]'', if ''/console'' parameter is not used along with ''/script'' or ''/command'', the script/command is executed without visual feedback (window). | With ''[[executables|winscp.exe]]'', if ''/console'' parameter is not used along with ''/script'' or ''/command'', the script/command is executed without visual feedback (window). | ||
| - | Use parameter ''/nointeractiveinput'', when feeding commands to ''[[executables|winscp.com]]'' using [[executables#redirection|standard input]], to make sure prompts for anything other than commands (such as password prompts) are cancelled. Also prevents error message popping up when fatal error occurs while starting WinSCP. When combined with ''/xmllog'' the fatal error is recorded in the %%XML%% log (&beta_feature) | + | Use parameter ''/nointeractiveinput'', when feeding commands to ''[[executables|winscp.com]]'' using [[executables#redirection|standard input]], to make sure prompts for anything other than commands (such as password prompts) are cancelled. Also prevents error message popping up when fatal error occurs while starting WinSCP. When combined with ''/xmllog'' the fatal error is recorded in the %%XML%% log. |
| <code batch> | <code batch> | ||
| Line 100: | Line 98: | ||
| The following parameters can be used to create a shortcut that initiates operation in GUI mode. They are not intended for automation, for that see [[scripting]]. | The following parameters can be used to create a shortcut that initiates operation in GUI mode. They are not intended for automation, for that see [[scripting]]. | ||
| - | Use ''/edit'' to open a remote file in WinSCP [[ui_editor|internal editor]]. &beta_feature | + | Use ''/edit'' to open a remote file in WinSCP [[ui_editor|internal editor]]. |
| With ''/synchronize'' or ''/keepuptodate'' parameter WinSCP performs //Synchronize// or //Keep remote directory up to date// commands respectively on the specified session and directories. A dialog to set options is displayed first. | With ''/synchronize'' or ''/keepuptodate'' parameter WinSCP performs //Synchronize// or //Keep remote directory up to date// commands respectively on the specified session and directories. A dialog to set options is displayed first. | ||
| Line 123: | Line 121: | ||
| Use ''nul'' instead of path to force WinSCP start with its default configuration and not save the configuration on exit. | Use ''nul'' instead of path to force WinSCP start with its default configuration and not save the configuration on exit. | ||
| - | With ''/rawconfig'' parameter you can set any configuration settings using raw format as in an INI file. The settings is identified using syntax ''section\name'', where the ''section'' is a path to configuration section from ''HKEY_CURRENT_USER\Software\Martin Prikryl\WinSCP 2\Configuration'' key in a registry or ''[Configuration]'' section in an INI file. E.g. to configure a reconnect interval use ''/rawconfig Interface\SessionReopenAuto=10000''. The parameter must come after a session URL (if any). The configuration set this way is preserved. &beta_feature | + | With ''/rawconfig'' parameter you can set any configuration settings using raw format as in an INI file. The settings is identified using syntax ''section\name'', where the ''section'' is a path to configuration section from ''HKEY_CURRENT_USER\Software\Martin Prikryl\WinSCP 2\Configuration'' key in a registry or ''[Configuration]'' section in an INI file. E.g. to configure a reconnect interval use ''/rawconfig Interface\SessionReopenAuto=10000''. The parameter must come after a session URL (if any). The configuration set this way is preserved. |
| ==== [[batchsettings]] Mass-modification of sites ==== | ==== [[batchsettings]] Mass-modification of sites ==== | ||
| Line 134: | Line 132: | ||
| winscp.exe /batchsettings clients/* ProxyMethod=3 ProxyHost=proxy | winscp.exe /batchsettings clients/* ProxyMethod=3 ProxyHost=proxy | ||
| </code> | </code> | ||
| - | |||
| - | &beta_feature | ||
| ==== Auxiliary ==== | ==== Auxiliary ==== | ||