commandline » Revisions »
Differences
This shows you the differences between the selected revisions of the page.
| commandline 2024-12-12 | commandline 2025-04-13 (current) | ||
| Line 1: | Line 1: | ||
| ====== Command-line Options ====== | ====== Command-line Options ====== | ||
| - | |||
| ===== [[parameters]] Parameters ===== | ===== [[parameters]] Parameters ===== | ||
| Parameters for ''[[executables|winscp.exe]]'' executable: | Parameters for ''[[executables|winscp.exe]]'' executable: | ||
| - | &lt;code batch&gt; | + | <code batch> |
| winscp.exe site|workspace|folder | winscp.exe site|workspace|folder | ||
| - | winscp.exe &lt;session_url&gt;[/path/[file]] | + | winscp.exe <session_url>[/path/[file]] |
| - | winscp.exe [mysession] [/sessionname=&lt;name&gt;] | + | winscp.exe [mysession] [/sessionname=<name>] |
| winscp.exe [mysession] [/newinstance] | winscp.exe [mysession] [/newinstance] | ||
| - | winscp.exe [mysession] /edit &lt;path&gt; | + | winscp.exe [mysession] /edit <path> |
| - | winscp.exe [mysession] /browse[=&lt;file&gt;] | + | winscp.exe [mysession] /browse[=<file>] |
| winscp.exe [mysession] /synchronize [local_directory] [remote_directory] [/defaults[=secs]] | winscp.exe [mysession] /synchronize [local_directory] [remote_directory] [/defaults[=secs]] | ||
| winscp.exe [mysession] /keepuptodate [local_directory] [remote_directory] [/defaults[=secs]] | winscp.exe [mysession] /keepuptodate [local_directory] [remote_directory] [/defaults[=secs]] | ||
| winscp.exe [mysession] /refresh [path] | winscp.exe [mysession] /refresh [path] | ||
| winscp.exe [mysession] /upload file1 file2 file3 ... [/defaults[=secs]] | winscp.exe [mysession] /upload file1 file2 file3 ... [/defaults[=secs]] | ||
| - | winscp.exe [mysession] [/privatekey=&lt;file&gt; [/passphrase=&lt;passphrase&gt;]] | + | winscp.exe [mysession] [/privatekey=<file> [/passphrase=<passphrase>]] |
| - | winscp.exe [mysession] [/hostkey=&lt;fingerprint&gt;] | + | winscp.exe [mysession] [/hostkey=<fingerprint>] |
| - | winscp.exe [mysession] [/username=&lt;user&gt;] [/password=&lt;pass&gt;] | + | winscp.exe [mysession] [/username=<user>] [/password=<pass>] |
| winscp.exe [mysession] [/passwordsfromfiles] | winscp.exe [mysession] [/passwordsfromfiles] | ||
| - | winscp.exe [mysession] [/clientcert=&lt;file&gt; [/passphrase=&lt;passphrase&gt;]] | + | winscp.exe [mysession] [/clientcert=<file> [/passphrase=<passphrase>]] |
| - | winscp.exe [mysession] [/certificate=&lt;fingerprint&gt;] | + | winscp.exe [mysession] [/certificate=<fingerprint>] |
| winscp.exe [mysession] [/passive[=on|off]] [/implicit|explicit] | winscp.exe [mysession] [/passive[=on|off]] [/implicit|explicit] | ||
| - | winscp.exe [mysession] [/timeout=&lt;sec&gt;] | + | winscp.exe [mysession] [/timeout=<sec>] |
| winscp.exe [mysession] [/rawsettings setting1=value1 setting2=value2 ...] | winscp.exe [mysession] [/rawsettings setting1=value1 setting2=value2 ...] | ||
| - | winscp.exe [/console] [/script=&lt;script_file&gt;] [/command command1 command2 ...] | + | winscp.exe [/console] [/script=<script_file>] [/command command1 command2 ...] |
| [/parameter // param1 ...] | [/parameter // param1 ...] | ||
| - | winscp.exe [/log=&lt;logfile&gt; [/loglevel=&lt;level&gt;] [/logsize=[&lt;count&gt;*]&lt;size&gt;]] | + | winscp.exe [/log=<logfile> [/loglevel=<level>] [/logsize=[<count>*]<size>]] |
| - | [/xmllog=&lt;logfile&gt; [/xmlgroups]] | + | [/xmllog=<logfile> [/xmlgroups]] |
| - | winscp.exe [/ini=&lt;inifile&gt;] | + | winscp.exe [/ini=<inifile>] |
| winscp.exe [/rawconfig config1=value1 config2=value2 ...] | winscp.exe [/rawconfig config1=value1 config2=value2 ...] | ||
| winscp.exe [/rawtransfersettings setting1=value1 setting2=value2 ...] | winscp.exe [/rawtransfersettings setting1=value1 setting2=value2 ...] | ||
| - | winscp.exe /batchsettings &lt;site_mask&gt; setting1=value1 setting2=value2 ... | + | winscp.exe /batchsettings <site_mask> setting1=value1 setting2=value2 ... |
| - | winscp.exe /keygen keyfile [/output=&lt;file&gt;] [/changepassphrase] | + | winscp.exe /keygen keyfile [/output=<file>] [/changepassphrase] |
| - | winscp.exe /keygen keyfile [/comment=&lt;text&gt;] [/certificate=&lt;file&gt;] | + | winscp.exe /keygen keyfile [/comment=<text>] [/certificate=<file>] |
| + | winscp.exe /copyid /identity=publickey mysession | ||
| winscp.exe /update | winscp.exe /update | ||
| winscp.exe /info | winscp.exe /info | ||
| winscp.exe /help | winscp.exe /help | ||
| - | &lt;/code&gt; | + | </code> |
| Parameters for ''[[executables|winscp.com]]'' executable: | Parameters for ''[[executables|winscp.com]]'' executable: | ||
| - | &lt;code batch&gt; | + | <code batch> |
| winscp.com [/script=script_file] [/command command1 command2 ...] | winscp.com [/script=script_file] [/command command1 command2 ...] | ||
| [/parameter // param1 ...] | [/parameter // param1 ...] | ||
| winscp.com [/stdout[=binary|chunked]] [/stdin] | winscp.com [/stdout[=binary|chunked]] [/stdin] | ||
| - | winscp.com [/log=&lt;logfile&gt; [/loglevel=&lt;level&gt;] [/logsize=[&lt;count&gt;*]&lt;size&gt;]] | + | winscp.com [/log=<logfile> [/loglevel=<level>] [/logsize=[<count>*]<size>]] |
| - | [/xmllog=&lt;logfile&gt; [/xmlgroups]] [/nointeractiveinput] | + | [/xmllog=<logfile> [/xmlgroups]] [/nointeractiveinput] |
| - | winscp.com [/ini=&lt;inifile&gt;] | + | winscp.com [/ini=<inifile>] |
| winscp.com [/rawconfig config1=value1 config2=value2 ...] | winscp.com [/rawconfig config1=value1 config2=value2 ...] | ||
| - | winscp.com /batchsettings &lt;site_mask&gt; setting1=value1 setting2=value2 ... | + | winscp.com /batchsettings <site_mask> setting1=value1 setting2=value2 ... |
| - | winscp.com /keygen keyfile [/output=&lt;file&gt;] [/changepassphrase] | + | winscp.com /keygen keyfile [/output=<file>] [/changepassphrase] |
| - | winscp.com /keygen keyfile [/comment=&lt;text&gt;] [/certificate=&lt;file&gt;] | + | winscp.com /keygen keyfile [/comment=<text>] [/certificate=<file>] |
| + | winscp.exe /copyid /identity=publickey mysession | ||
| winscp.com /info | winscp.com /info | ||
| winscp.com /help | winscp.com /help | ||
| - | &lt;/code&gt; | + | </code> |
| ==== [[session]] Session ==== | ==== [[session]] Session ==== | ||
| Line 212: | Line 213: | ||
| winscp.com /keygen mykey.pem -o mykey.ppk -C "Converted from OpenSSH format" | winscp.com /keygen mykey.pem -o mykey.ppk -C "Converted from OpenSSH format" | ||
| </code> | </code> | ||
| + | |||
| + | ==== [[copyid]] Public key installation ==== | ||
| + | |||
| + | Use the ''/copyid'' switch to [[guide_public_key#configure_openssh|install your public key in a server's ''authorized_keys'' file]]. Use ''/identity'' switch to specify the path to your key pair in PPK format or public key in ''authorized_keys'' format. Supported with SFTP protocol only. | ||
| + | |||
| + | For example, to install public key from ''mykey.ppk'' key pair file, use: | ||
| + | |||
| + | <code batch> | ||
| + | winscp.com /copyid /identity=mykey.ppk martin@example.com | ||
| + | </code> | ||
| + | |||
| + | The functionality is a replacement for [[&man_ref(1,ssh-copy-id)|OpenSSH ''ssh-copy-id'' script]]. Contrary to the OpenSSH script, it does not require shell interpreter locally. Additionally, it uses SFTP protocol, so it does not rely on a shell access and shell commands on the server. For a compatibility with the script, the ''-i'' switch is understood as an alias to ''/identity''. So, for features supported by WinSCP, you can use the same arguments as for ''ssh-copy-id'', just prefixed with ''/copyid''. | ||
| ==== [[auxiliary]] Auxiliary ==== | ==== [[auxiliary]] Auxiliary ==== | ||