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. | | ||