Differences

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

Differences

Documentation

Support

Associations

Follow Us

commandline 2026-01-15		commandline 2026-03-10 (current)
	Line 9:		Line 9:
	winscp.exe [mysession] [/newinstance]		winscp.exe [mysession] [/newinstance]
	winscp.exe [mysession] /edit <path>		winscp.exe [mysession] /edit <path>
-	winscp.exe [mysession] /browse[=<file>]	+	winscp.exe [mysession] /explore[=<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]]
	Line 95:		Line 95:
	winscp.exe ftps://martin:password@example.com/		winscp.exe ftps://martin:password@example.com/
	</code>		</code>
-

	==== [[logging]] Logging ====		==== [[logging]] Logging ====

-	With &#039;&#039;/log&#039;&#039; parameter you may turn on [[logging\|session logging]] to file specified by [[local_path\|local path]]. In the path you can use the same patterns as in the [[ui_pref_logging#session_log\|logging preferences]].	+	With ''/log'' parameter you may turn on [[logging\|session logging]] to file specified by [[local_path\|local path]]. In the path you can use the same patterns as in the [[ui_pref_logging#session_log\|logging preferences]].

-	Use parameter &#039;&#039;/==loglevel==&#039;&#039; to change logging level. The value can be in range &#039;&#039;-1&#039;&#039;...&#039;&#039;2&#039;&#039; (for //Reduced//, //Normal//, //Debug 1// and //Debug 2// logging levels respectively). Append additional &#039;&#039;&#039;&#039; to enable password logging (e.g. &#039;&#039;/loglevel=2&#039;&#039;).((Append &#039;&#039;*-&#039;&#039; to disable password logging.))	+	Use parameter ''/==loglevel=='' to change logging level. The value can be in range ''-1''...''2'' (for //Reduced//, //Normal//, //Debug 1// and //Debug 2// logging levels respectively). Append additional '''' to enable password logging (e.g. ''/loglevel=2'').((Append ''*-'' to disable password logging.))

-	Use parameter &#039;&#039;/==logsize==&#039;&#039; to configure log file size limit and log file rotation. Specify maximum size in bytes, optionally with &#039;&#039;K&#039;&#039;, &#039;&#039;M&#039;&#039; or &#039;&#039;G&#039;&#039; units. Optionally you can limit number of archived log files using &#039;&#039;count&#039;&#039; prefix. For example &#039;&#039;/logsize=510M&#039;&#039; will limit log file size to 10 MB and will allow up to 5 archived logs.	+	Use parameter ''/==logsize=='' to configure log file size limit and log file rotation. Specify maximum size in bytes, optionally with ''K'', ''M'' or ''G'' units. Optionally you can limit number of archived log files using ''count'' prefix. For example ''/logsize=510M'' will limit log file size to 10 MB and will allow up to 5 archived logs.

-	&lt;code batch&gt;	+	<code batch>
-	winscp.exe sftp://martin@example.com/ /log=&quot;C:\winscp.log&quot; /loglevel=0	+	winscp.exe sftp://martin@example.com/ /log="C:\winscp.log" /loglevel=0
-	&lt;/code&gt;	+	</code>

-	With &#039;&#039;/xmllog&#039;&#039; parameter you may turn on [[logging_xml\|XML logging]] to file specified by local path. ((For backward compatibility, XML logging can also be enabled using &#039;&#039;/log&#039;&#039; parameter with filename ending with &#039;&#039;.xml&#039;&#039; extension.)) In the path you can use the same patterns as in the [[ui_pref_logging#session_log\|logging preferences]].	+	With ''/xmllog'' parameter you may turn on [[logging_xml\|XML logging]] to file specified by local path. ((For backward compatibility, XML logging can also be enabled using ''/log'' parameter with filename ending with ''.xml'' extension.)) In the path you can use the same patterns as in the [[ui_pref_logging#session_log\|logging preferences]].

-	Use parameter &#039;&#039;/xmlgroups&#039;&#039; along with &#039;&#039;/xmllog&#039;&#039;, to [[logging_xml#group\|group]] all XML log elements belonging to the same command under parent &#039;&#039;group&#039;&#039; element.	+	Use parameter ''/xmlgroups'' along with ''/xmllog'', to [[logging_xml#group\|group]] all XML log elements belonging to the same command under parent ''group'' element.


	Line 144:		Line 143:
	Use ''/==edit=='' to open a remote file in WinSCP [[ui_editor\|internal editor]].		Use ''/==edit=='' to open a remote file in WinSCP [[ui_editor\|internal editor]].

-	Use ''/browse'' to select the specified file in (both) [[ui_file_panel\|file panel(s)]]. The switch can also be used together with a [[session_url#file\|file URL]] for the same effect, overriding the default [[task_download#url\|download action]].	+	Use ''/explore'' (''/browse'' in older versions) &beta to select the specified file in (both) [[ui_file_panel\|file panel(s)]]. The switch can also be used together with a [[session_url#file\|file URL]] for the same effect, overriding the default [[task_download#url\|download action]].

	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.