Differences

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

rawconfig 2023-02-28		rawconfig 2023-12-12 (current)
	Line 19:		Line 19:
	\| ''Interface\==KeepUpToDateChangeDelay=='' \| Upload delay after change is detected while [[task_keep_up_to_date\|Keeping remote directory up to date]] \| In milliseconds. \|		\| ''Interface\==KeepUpToDateChangeDelay=='' \| Upload delay after change is detected while [[task_keep_up_to_date\|Keeping remote directory up to date]] \| In milliseconds. \|
	\| ''Interface\==MimeTypes=='' \| MIME type (Content type) overrides. \| Comma separated list of overrides with syntax ''mask=mime_type'', where ''mask'' is a [[file_mask\|file mask]]. \\ Example: ''.js=application/javascript,.png=image/png'' \|		\| ''Interface\==MimeTypes=='' \| MIME type (Content type) overrides. \| Comma separated list of overrides with syntax ''mask=mime_type'', where ''mask'' is a [[file_mask\|file mask]]. \\ Example: ''.js=application/javascript,.png=image/png'' \|
		+	\| ''Interface\==QueueTransferLimitMax=='' \| Limit of [[ui_pref_background#background_transfers\|Maximal number of transfers at the same time]] \| Defaults to 9. \|
	\| ''Interface\==LocalIconsByExt=='' \| Turn off loading icons from local files \| ''0'' = Load icons from local files, ''1'' = Resolve icons for local files by file extension only \|		\| ''Interface\==LocalIconsByExt=='' \| Turn off loading icons from local files \| ''0'' = Load icons from local files, ''1'' = Resolve icons for local files by file extension only \|
	\| ''Interface\==HonorDrivePolicy=='' \| Follow Windows File Explorer configuration for hiding drives \| ''0'' = Show all drives, ''1'' = Hide hidden drives \|		\| ''Interface\==HonorDrivePolicy=='' \| Follow Windows File Explorer configuration for hiding drives \| ''0'' = Show all drives, ''1'' = Hide hidden drives \|
	Line 24:		Line 25:
	\| ''Interface\==LocaleSafe=='' \| [[ui_pref_languages\|Language]] \| [[https://learn.microsoft.com/en-us/windows/win32/intl/language-identifier-constants-and-strings\|Decimal LCID]] of the language/locale. E.g. ''1033'' for English (United States) \|		\| ''Interface\==LocaleSafe=='' \| [[ui_pref_languages\|Language]] \| [[https://learn.microsoft.com/en-us/windows/win32/intl/language-identifier-constants-and-strings\|Decimal LCID]] of the language/locale. E.g. ''1033'' for English (United States) \|
	\| ''==Interface\BeepSound=='' \| A path to a sound file or system sound alias for the //[[ui_pref_environment#notifications\|Beep when work finishes]]// function. \| Defaults to system sound alias ''SystemDefault''. \|		\| ''==Interface\BeepSound=='' \| A path to a sound file or system sound alias for the //[[ui_pref_environment#notifications\|Beep when work finishes]]// function. \| Defaults to system sound alias ''SystemDefault''. \|
		+	\| ''Interface\==FlashTaskbar=='' \| Flash taskbar button when user interaction is needed \| ''0'' = Off, ''1'' = On \|
	\| ''Interface\MinimizeToTray'' \| [[ui_pref_window\|Minimize main window to taskbar status area]]. \| ''0'' = Off, ''1'' = On \|		\| ''Interface\MinimizeToTray'' \| [[ui_pref_window\|Minimize main window to taskbar status area]]. \| ''0'' = Off, ''1'' = On \|
	\| ''==Interface\SessionTabNameFormat=='' \| Format of session tab title \| ''0'' = Only session name, ''1'' = Distinguish multiple sessions opened to the same site by the name of the current folder, ''2'' = As ''1'', but truncate long paths \|		\| ''==Interface\SessionTabNameFormat=='' \| Format of session tab title \| ''0'' = Only session name, ''1'' = Distinguish multiple sessions opened to the same site by the name of the current folder, ''2'' = As ''1'', but truncate long paths \|
	\| ''Interface\TryFtpWhenSshFails'' \| [[ui_pref_network\|When SFTP connection is rejected, knock FTP port]] \| ''0'' = Off, ''1'' = On \|		\| ''Interface\TryFtpWhenSshFails'' \| [[ui_pref_network\|When SFTP connection is rejected, knock FTP port]] \| ''0'' = Off, ''1'' = On \|
	\| ''Interface\SynchronizeOptions'' \| Options for [[ui_keepuptodate\|Keep Remote Directory up to Date]] \| Bitmask. ''1'' = //Update subdirectories//, ''2'' = //Synchronize on start//, ''4'' = Ask user whether to //Synchronize on start//, ''8'' = //Continue on error// \\ The ''4'' and ''8'' has an effect with ''[[commandline#operations\|/keepuptodate]]'' command-line operation only. \|		\| ''Interface\SynchronizeOptions'' \| Options for [[ui_keepuptodate\|Keep Remote Directory up to Date]] \| Bitmask. ''1'' = //Update subdirectories//, ''2'' = //Synchronize on start//, ''4'' = Ask user whether to //Synchronize on start//, ''8'' = //Continue on error// \\ The ''4'' and ''8'' has an effect with ''[[commandline#operations\|/keepuptodate]]'' command-line operation only. \|
-	\| ''==Interface\SynchronizeParams=='' \| Options for [[ui_synchronize\|Synchronization]] and [[ui_keepuptodate\|Keep Remote Directory up to Date]] \| Bitmask. ''1'' = //Delete files// (with ''/keepuptodate'' and ''/synchronize'' [[commandline#operations\|command-line operations only]], in scripting use the ''-delete'' switch, in .NET assembly, use the ''removeFiles'' argument of the ''[[library_session_synchronizedirectories\|Session.SynchronizeDirectories]]''), ''4'' = //Existing files only//, ''64'' = //Preview changes// (with ''/synchronize'' command-line operation only, in scripting use the ''[[scriptcommand_synchronize#preview\|-preview]]'' switch, not available in .NET assembly), ''256'' = //Synchronize timestamps// mode, ''512'' = Turn off //Modification time comparison criteria// (with ''/synchronize'' command-line operation only, in scripting use the ''-criteria=none'' or ''=size'' switch, in .NET assembly, set the ''criteria'' argument of the ''Session.SynchronizeDirectories'' to ''SynchronizationCriteria.None'' or ''.Size''), ''1024'' = //File size comparison criteria// (with ''/synchronize'' command-line operation only, in scripting use the ''[[scriptcommand_synchronize#criteria\|-criteria=size]]'' or ''=either'' switch, in .NET assembly, set the ''criteria'' argument of the ''Session.SynchronizeDirectories'' to ''SynchronizationCriteria.Size'' or ''.Either''), ''4096'' = //Mirror// mode (with ''/synchronize'' command-line operations only, in scripting use the ''[[scriptcommand_synchronize#mirror\|-mirror]]'' switch, in .NET assembly, use the ''mirror'' argument of the ''[[library_session_synchronizedirectories\|Session.SynchronizeDirectories]]''), ''8192'' = //Case sensitive comparison criteria// \|	+	\| ''==Interface\SynchronizeParams=='' \| Options for [[ui_synchronize\|Synchronization]] and [[ui_keepuptodate\|Keep Remote Directory up to Date]] \| Bitmask. ''1'' = //Delete files// (with ''/keepuptodate'' and ''/synchronize'' [[commandline#operations\|command-line operations only]], in scripting use the ''-delete'' switch, in .NET assembly use the ''removeFiles'' argument of the ''[[library_session_synchronizedirectories\|Session.SynchronizeDirectories]]''), ''4'' = //Existing files only//, ''64'' = //Preview changes// (with ''/synchronize'' command-line operation only, in scripting use the [[scriptcommand_synchronize#preview\|''-preview'' switch]], in .NET assembly use [[library_session_comparedirectories\|''Session.CompareDirectories'' method]]), ''256'' = //Synchronize timestamps// mode, ''512'' = Turn off //Modification time comparison criteria// (with ''/synchronize'' command-line operation only, in scripting use the [[scriptcommand_synchronize#criteria\|''-criteria'' switch]], in .NET assembly use the ''criteria'' argument of the ''Session.SynchronizeDirectories''), ''1024'' = //File size comparison criteria// (with ''/synchronize'' command-line operation only, see ''512''), ''4096'' = //Mirror// mode (with ''/synchronize'' command-line operations only, in scripting use the [[scriptcommand_synchronize#mirror\|''-mirror'' switch]], in .NET assembly use the ''mirror'' argument of the ''Session.SynchronizeDirectories''), ''8192'' = //Case sensitive comparison criteria//, ''16384'' = //Checksum comparison criteria// (with ''/synchronize'' command-line operation only, see ''512'') \|
	\| ''Interface\MaxWatchDirectories'' \| [[ui_keepuptodate\|Keep Remote Directory up to Date]] directory count warning limit \| \|		\| ''Interface\MaxWatchDirectories'' \| [[ui_keepuptodate\|Keep Remote Directory up to Date]] directory count warning limit \| \|
	\| ''Interface\==ScriptProgressFileNameLimit=='' \| Maximal length of a filename in scripting progress output \| Defaults to ''25''. \|		\| ''Interface\==ScriptProgressFileNameLimit=='' \| Maximal length of a filename in scripting progress output \| Defaults to ''25''. \|
	Line 54:		Line 56:
	<code powershell>		<code powershell>
	$session.AddRawConfiguration("Interface\ExternalIpAddress", "198.51.100.10")		$session.AddRawConfiguration("Interface\ExternalIpAddress", "198.51.100.10")
		+	</code>
		+
		+	In WinSCP GUI, to enable an option (which is not configurable directly in the GUI), it's usually enough to run WinSCP GUI once like this:
		+	<code batch>
		+	winscp.exe /rawconfig Interface\HonorDrivePolicy=off
	</code>		</code>

rawconfig 2023-02-28		rawconfig 2023-12-12 (current)
	Line 19:		Line 19:
	\| ''Interface\==KeepUpToDateChangeDelay=='' \| Upload delay after change is detected while [[task_keep_up_to_date\|Keeping remote directory up to date]] \| In milliseconds. \|		\| ''Interface\==KeepUpToDateChangeDelay=='' \| Upload delay after change is detected while [[task_keep_up_to_date\|Keeping remote directory up to date]] \| In milliseconds. \|
	\| ''Interface\==MimeTypes=='' \| MIME type (Content type) overrides. \| Comma separated list of overrides with syntax ''mask=mime_type'', where ''mask'' is a [[file_mask\|file mask]]. \\ Example: ''.js=application/javascript,.png=image/png'' \|		\| ''Interface\==MimeTypes=='' \| MIME type (Content type) overrides. \| Comma separated list of overrides with syntax ''mask=mime_type'', where ''mask'' is a [[file_mask\|file mask]]. \\ Example: ''.js=application/javascript,.png=image/png'' \|
		+	\| ''Interface\==QueueTransferLimitMax=='' \| Limit of [[ui_pref_background#background_transfers\|Maximal number of transfers at the same time]] \| Defaults to 9. \|
	\| ''Interface\==LocalIconsByExt=='' \| Turn off loading icons from local files \| ''0'' = Load icons from local files, ''1'' = Resolve icons for local files by file extension only \|		\| ''Interface\==LocalIconsByExt=='' \| Turn off loading icons from local files \| ''0'' = Load icons from local files, ''1'' = Resolve icons for local files by file extension only \|
	\| ''Interface\==HonorDrivePolicy=='' \| Follow Windows File Explorer configuration for hiding drives \| ''0'' = Show all drives, ''1'' = Hide hidden drives \|		\| ''Interface\==HonorDrivePolicy=='' \| Follow Windows File Explorer configuration for hiding drives \| ''0'' = Show all drives, ''1'' = Hide hidden drives \|
	Line 24:		Line 25:
	\| ''Interface\==LocaleSafe=='' \| [[ui_pref_languages\|Language]] \| [[https://learn.microsoft.com/en-us/windows/win32/intl/language-identifier-constants-and-strings\|Decimal LCID]] of the language/locale. E.g. ''1033'' for English (United States) \|		\| ''Interface\==LocaleSafe=='' \| [[ui_pref_languages\|Language]] \| [[https://learn.microsoft.com/en-us/windows/win32/intl/language-identifier-constants-and-strings\|Decimal LCID]] of the language/locale. E.g. ''1033'' for English (United States) \|
	\| ''==Interface\BeepSound=='' \| A path to a sound file or system sound alias for the //[[ui_pref_environment#notifications\|Beep when work finishes]]// function. \| Defaults to system sound alias ''SystemDefault''. \|		\| ''==Interface\BeepSound=='' \| A path to a sound file or system sound alias for the //[[ui_pref_environment#notifications\|Beep when work finishes]]// function. \| Defaults to system sound alias ''SystemDefault''. \|
		+	\| ''Interface\==FlashTaskbar=='' \| Flash taskbar button when user interaction is needed \| ''0'' = Off, ''1'' = On \|
	\| ''Interface\MinimizeToTray'' \| [[ui_pref_window\|Minimize main window to taskbar status area]]. \| ''0'' = Off, ''1'' = On \|		\| ''Interface\MinimizeToTray'' \| [[ui_pref_window\|Minimize main window to taskbar status area]]. \| ''0'' = Off, ''1'' = On \|
	\| ''==Interface\SessionTabNameFormat=='' \| Format of session tab title \| ''0'' = Only session name, ''1'' = Distinguish multiple sessions opened to the same site by the name of the current folder, ''2'' = As ''1'', but truncate long paths \|		\| ''==Interface\SessionTabNameFormat=='' \| Format of session tab title \| ''0'' = Only session name, ''1'' = Distinguish multiple sessions opened to the same site by the name of the current folder, ''2'' = As ''1'', but truncate long paths \|
	\| ''Interface\TryFtpWhenSshFails'' \| [[ui_pref_network\|When SFTP connection is rejected, knock FTP port]] \| ''0'' = Off, ''1'' = On \|		\| ''Interface\TryFtpWhenSshFails'' \| [[ui_pref_network\|When SFTP connection is rejected, knock FTP port]] \| ''0'' = Off, ''1'' = On \|
	\| ''Interface\SynchronizeOptions'' \| Options for [[ui_keepuptodate\|Keep Remote Directory up to Date]] \| Bitmask. ''1'' = //Update subdirectories//, ''2'' = //Synchronize on start//, ''4'' = Ask user whether to //Synchronize on start//, ''8'' = //Continue on error// \\ The ''4'' and ''8'' has an effect with ''[[commandline#operations\|/keepuptodate]]'' command-line operation only. \|		\| ''Interface\SynchronizeOptions'' \| Options for [[ui_keepuptodate\|Keep Remote Directory up to Date]] \| Bitmask. ''1'' = //Update subdirectories//, ''2'' = //Synchronize on start//, ''4'' = Ask user whether to //Synchronize on start//, ''8'' = //Continue on error// \\ The ''4'' and ''8'' has an effect with ''[[commandline#operations\|/keepuptodate]]'' command-line operation only. \|
-	\| ''==Interface\SynchronizeParams=='' \| Options for [[ui_synchronize\|Synchronization]] and [[ui_keepuptodate\|Keep Remote Directory up to Date]] \| Bitmask. ''1'' = //Delete files// (with ''/keepuptodate'' and ''/synchronize'' [[commandline#operations\|command-line operations only]], in scripting use the ''-delete'' switch, in .NET assembly, use the ''removeFiles'' argument of the ''[[library_session_synchronizedirectories\|Session.SynchronizeDirectories]]''), ''4'' = //Existing files only//, ''64'' = //Preview changes// (with ''/synchronize'' command-line operation only, in scripting use the ''[[scriptcommand_synchronize#preview\|-preview]]'' switch, not available in .NET assembly), ''256'' = //Synchronize timestamps// mode, ''512'' = Turn off //Modification time comparison criteria// (with ''/synchronize'' command-line operation only, in scripting use the ''-criteria=none'' or ''=size'' switch, in .NET assembly, set the ''criteria'' argument of the ''Session.SynchronizeDirectories'' to ''SynchronizationCriteria.None'' or ''.Size''), ''1024'' = //File size comparison criteria// (with ''/synchronize'' command-line operation only, in scripting use the ''[[scriptcommand_synchronize#criteria\|-criteria=size]]'' or ''=either'' switch, in .NET assembly, set the ''criteria'' argument of the ''Session.SynchronizeDirectories'' to ''SynchronizationCriteria.Size'' or ''.Either''), ''4096'' = //Mirror// mode (with ''/synchronize'' command-line operations only, in scripting use the ''[[scriptcommand_synchronize#mirror\|-mirror]]'' switch, in .NET assembly, use the ''mirror'' argument of the ''[[library_session_synchronizedirectories\|Session.SynchronizeDirectories]]''), ''8192'' = //Case sensitive comparison criteria// \|	+	\| ''==Interface\SynchronizeParams=='' \| Options for [[ui_synchronize\|Synchronization]] and [[ui_keepuptodate\|Keep Remote Directory up to Date]] \| Bitmask. ''1'' = //Delete files// (with ''/keepuptodate'' and ''/synchronize'' [[commandline#operations\|command-line operations only]], in scripting use the ''-delete'' switch, in .NET assembly use the ''removeFiles'' argument of the ''[[library_session_synchronizedirectories\|Session.SynchronizeDirectories]]''), ''4'' = //Existing files only//, ''64'' = //Preview changes// (with ''/synchronize'' command-line operation only, in scripting use the [[scriptcommand_synchronize#preview\|''-preview'' switch]], in .NET assembly use [[library_session_comparedirectories\|''Session.CompareDirectories'' method]]), ''256'' = //Synchronize timestamps// mode, ''512'' = Turn off //Modification time comparison criteria// (with ''/synchronize'' command-line operation only, in scripting use the [[scriptcommand_synchronize#criteria\|''-criteria'' switch]], in .NET assembly use the ''criteria'' argument of the ''Session.SynchronizeDirectories''), ''1024'' = //File size comparison criteria// (with ''/synchronize'' command-line operation only, see ''512''), ''4096'' = //Mirror// mode (with ''/synchronize'' command-line operations only, in scripting use the [[scriptcommand_synchronize#mirror\|''-mirror'' switch]], in .NET assembly use the ''mirror'' argument of the ''Session.SynchronizeDirectories''), ''8192'' = //Case sensitive comparison criteria//, ''16384'' = //Checksum comparison criteria// (with ''/synchronize'' command-line operation only, see ''512'') \|
	\| ''Interface\MaxWatchDirectories'' \| [[ui_keepuptodate\|Keep Remote Directory up to Date]] directory count warning limit \| \|		\| ''Interface\MaxWatchDirectories'' \| [[ui_keepuptodate\|Keep Remote Directory up to Date]] directory count warning limit \| \|
	\| ''Interface\==ScriptProgressFileNameLimit=='' \| Maximal length of a filename in scripting progress output \| Defaults to ''25''. \|		\| ''Interface\==ScriptProgressFileNameLimit=='' \| Maximal length of a filename in scripting progress output \| Defaults to ''25''. \|
	Line 54:		Line 56:
	<code powershell>		<code powershell>
	$session.AddRawConfiguration("Interface\ExternalIpAddress", "198.51.100.10")		$session.AddRawConfiguration("Interface\ExternalIpAddress", "198.51.100.10")
		+	</code>
		+
		+	In WinSCP GUI, to enable an option (which is not configurable directly in the GUI), it's usually enough to run WinSCP GUI once like this:
		+	<code batch>
		+	winscp.exe /rawconfig Interface\HonorDrivePolicy=off
	</code>		</code>

Differences

Documentation

Support

Associations

Follow Us