Differences

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

2013-07-29 2013-07-30
added rawsettings example, removed/updates examples so that there are none with non-explicit protocol (martin) favor tls (martin)
Line 18: Line 18:
| ''-timeout=<sec>''          | Server response timeout | | ''-timeout=<sec>''          | Server response timeout |
| ''%%-hostkey="<fingerprint>"%%'' | Specifies fingerprint of expected [[ssh#verifying_the_host_key|SSH host key]] (or several alternative fingerprints separated by semicolon). It makes WinSCP automatically [[scripting#hostkey|accept hostkey]] with the fingerprint. As the hostkey fingerprint contains spaces you need to surround it by quotes. //Learn how to [[faq_script_hostkey|obtain host key fingerprint]]//. \\ In exceptional situations, when security is not required, you can use value ''*'' to accept any hostkey. In this case, script output and log file will include warning about insecure connection. &beta_feature \\ [[SFTP]] and [[SCP]] protocols only. | | ''%%-hostkey="<fingerprint>"%%'' | Specifies fingerprint of expected [[ssh#verifying_the_host_key|SSH host key]] (or several alternative fingerprints separated by semicolon). It makes WinSCP automatically [[scripting#hostkey|accept hostkey]] with the fingerprint. As the hostkey fingerprint contains spaces you need to surround it by quotes. //Learn how to [[faq_script_hostkey|obtain host key fingerprint]]//. \\ In exceptional situations, when security is not required, you can use value ''*'' to accept any hostkey. In this case, script output and log file will include warning about insecure connection. &beta_feature \\ [[SFTP]] and [[SCP]] protocols only. |
-| ''%%-certificate="<fingerprint>"%%'' | Specifies fingerprint of expected [[ftps#certificate|SSL/TLS certificate]] (or several fingerprints separated by semicolon). It makes WinSCP automatically [[scripting#hostkey|accept certificate]] with the fingerprint. \\ In exceptional situations, when security is not required, you can use value ''*'' to accept any certificate. In this case, script output and log file will include warning about insecure connection. &beta_feature \\ [[ftps|FTPS]] protocol only. |+| ''%%-certificate="<fingerprint>"%%'' | Specifies fingerprint of expected [[ftps#certificate|TLS/SSL certificate]] (or several fingerprints separated by semicolon). It makes WinSCP automatically [[scripting#hostkey|accept certificate]] with the fingerprint. \\ In exceptional situations, when security is not required, you can use value ''*'' to accept any certificate. In this case, script output and log file will include warning about insecure connection. &beta_feature \\ [[ftps|FTPS]] protocol only. |
| ''-passive=on%%|%%off''                | Enables [[ui_login_connection#connection|passive]] (''=on'') or active (''=off'') transfer mode ([[FTP]] protocol only). | | ''-passive=on%%|%%off''                | Enables [[ui_login_connection#connection|passive]] (''=on'') or active (''=off'') transfer mode ([[FTP]] protocol only). |
| ''-implicit''                | Implicit TLS/SSL ([[ftps|FTPS protocol]] only) | | ''-implicit''                | Implicit TLS/SSL ([[ftps|FTPS protocol]] only) |
-| ''-explicitssl''            | Explicit SSL ([[ftps|FTPS protocol]] only) | 
| ''-explicittls''            | Explicit TLS ([[ftps|FTPS protocol]] only) | | ''-explicittls''            | Explicit TLS ([[ftps|FTPS protocol]] only) |
 +| ''-explicitssl''            | Explicit SSL ([[ftps|FTPS protocol]] only) |
| ''-rawsettings setting1=value1 setting2=value2 ...'' | Allows configuring any site settings using [[rawsettings|raw format]] as in an INI file. E.g. to enable SSH compression and agent forwarding use ''-rawsettings Compression=1 AgentFwd=1''. | | ''-rawsettings setting1=value1 setting2=value2 ...'' | Allows configuring any site settings using [[rawsettings|raw format]] as in an INI file. E.g. to enable SSH compression and agent forwarding use ''-rawsettings Compression=1 AgentFwd=1''. |
Line 52: Line 52:
| ''-passive''      | Set ''[[library_sessionoptions|SessionOptions.FtpMode]]'' to ''FtpMode.Passive'' for ''on'' or ''FtpMode.Active'' \\ [[library_powershell#enums|Enumeration syntax]] in PowerShell is like ''[WinSCP.FtpMode]::Passive''. | | ''-passive''      | Set ''[[library_sessionoptions|SessionOptions.FtpMode]]'' to ''FtpMode.Passive'' for ''on'' or ''FtpMode.Active'' \\ [[library_powershell#enums|Enumeration syntax]] in PowerShell is like ''[WinSCP.FtpMode]::Passive''. |
| ''-implicit''      | Set ''[[library_sessionoptions|SessionOptions.FtpSecure]]'' to ''FtpSecure.Implicit'' (''[WinSCP.FtpSecure]::Implicit'' in PowerShell). | | ''-implicit''      | Set ''[[library_sessionoptions|SessionOptions.FtpSecure]]'' to ''FtpSecure.Implicit'' (''[WinSCP.FtpSecure]::Implicit'' in PowerShell). |
-| ''-explicitssl''  | Set ''[[library_sessionoptions|SessionOptions.FtpSecure]]'' to ''FtpSecure.ExplicitSsl'' (''[WinSCP.FtpSecure]::ExplicitSsl''). | 
| ''-explicittls''  | Set ''[[library_sessionoptions|SessionOptions.FtpSecure]]'' to ''FtpSecure.ExplicitTls'' (''[WinSCP.FtpSecure]::ExplicitTls''). | | ''-explicittls''  | Set ''[[library_sessionoptions|SessionOptions.FtpSecure]]'' to ''FtpSecure.ExplicitTls'' (''[WinSCP.FtpSecure]::ExplicitTls''). |
 +| ''-explicitssl''  | Set ''[[library_sessionoptions|SessionOptions.FtpSecure]]'' to ''FtpSecure.ExplicitSsl'' (''[WinSCP.FtpSecure]::ExplicitSsl''). |
| ''-rawsettings''  | Call ''[[library_sessionoptions|SessionOptions.AddRawSettings]]'' for every key/value pair in switch parameters. | | ''-rawsettings''  | Call ''[[library_sessionoptions|SessionOptions.AddRawSettings]]'' for every key/value pair in switch parameters. |

Last modified: by martin